Gestire le dipendenze dei pacchetti nelle applicazioni .NET

Articolo
2025-04-22

Questo articolo illustra come aggiungere e rimuovere le dipendenze dei pacchetti modificando il file di progetto o usando l'interfaccia della riga di comando.

Elemento <PackageReference>

L'elemento <PackageReference> del file di progetto ha la struttura seguente:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" />

L'attributo Include specifica l'ID del pacchetto da aggiungere al progetto. L'attributo Version specifica la versione da ottenere. Le versioni vengono specificate in base alle regole della versione di NuGet.

Usare le condizioni per aggiungere una dipendenza disponibile solo in una destinazione specifica, come illustrato nell'esempio seguente:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />

La dipendenza nell'esempio precedente sarà valida solo se la compilazione avviene per quel target specifico. Il $(TargetFramework) nella condizione è una proprietà MSBuild che viene impostata nel progetto. Per le applicazioni .NET più comuni, non è necessario eseguire questa operazione.

Aggiungere e rimuovere dipendenze

È possibile aggiungere e rimuovere dipendenze modificando il file di progetto o tramite i comandi dell'interfaccia della riga di comando di .NET .

Modificare il file di progetto

Per aggiungere una dipendenza, aggiungere un <PackageReference> elemento all'interno di un <ItemGroup> elemento. È possibile aggiungerne uno esistente <ItemGroup> o crearne uno nuovo.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    ...
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
  </ItemGroup>

</Project>

Per rimuovere una dipendenza, rimuovere l'elemento <PackageReference> dal file di progetto.

Usare la CLI

Per aggiungere una dipendenza, eseguire il dotnet package add comando , come illustrato nell'esempio seguente. Se si usa una versione SDK di .NET 9 o versioni precedenti, usare invece il dotnet add package modulo.

dotnet package add Microsoft.EntityFrameworkCore

Per rimuovere una dipendenza, eseguire il dotnet package remove comando , come illustrato nell'esempio seguente. Se si usa una versione SDK di .NET 9 o versioni precedenti, usare invece il dotnet remove package modulo.

dotnet package remove Microsoft.EntityFrameworkCore

Suggerimenti

Gli input per l'operazione di ripristino non devono essere inclusi nei file .targets o .props di un pacchetto referenziato. Gli input possono includere PackageReference elementi, ExcludeAssets attributi, i feed NuGet da usare o altre configurazioni di NuGet. I file con estensione targets e props dei pacchetti non vengono usati fino al completamento del ripristino di NuGet. Qualsiasi elemento necessario per il ripristino deve trovarsi nel file di progetto o nel file con estensione targets del progetto stesso, non una dipendenza del pacchetto.
Per usare ASP.NET API in un'applicazione console o in una libreria di classi, aggiungere un elemento FrameworkReference al file di progetto:

<FrameworkReference Include="Microsoft.AspNetCore.App" />

Per altre informazioni, vedere Usare il framework condiviso ASP.NET Core.

Condividi tramite