Gestire le dipendenze nelle applicazioni .NET

Questo articolo illustra come aggiungere e rimuovere dipendenze di pacchetto, progetto e assembly.

Aggiungere e rimuovere le dipendenze dei pacchetti

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

Usare la CLI

Per aggiungere una dipendenza, eseguire il comando per la versione dell'SDK dotnet package :

dotnet package add Microsoft.EntityFrameworkCore

Per rimuovere una dipendenza, eseguire il comando per la versione dell'SDK dotnet package :

dotnet package remove Microsoft.EntityFrameworkCore

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>

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.

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

Per ulteriori informazioni sull'elemento PackageReference, vedere il riferimento di MSBuild per i progetti SDK .NET.

Aggiungere e rimuovere riferimenti al progetto

Usare un riferimento da progetto a progetto quando il progetto dipende da un altro progetto. Per aggiungere e rimuovere riferimenti al progetto, modificare il file di progetto o usare l'interfaccia della riga di comando.

Usare la CLI

Per aggiungere un riferimento al progetto, eseguire il comando per la dotnet reference versione dell'SDK.

dotnet reference add ../MyLibrary/MyLibrary.csproj

Per rimuovere un riferimento al progetto, eseguire il comando seguente per la versione dell'SDK:

dotnet reference remove ../MyLibrary/MyLibrary.csproj

Modificare il file di progetto

L'elemento <ProjectReference> del file di progetto identifica il percorso del progetto a cui si fa riferimento. Per aggiungere un riferimento al progetto, aggiungere un <ProjectReference> elemento all'interno di un <ItemGroup> elemento. È possibile aggiungerne uno esistente <ItemGroup> o crearne uno nuovo.

<ItemGroup>
  <ProjectReference Include="../MyLibrary/MyLibrary.csproj" />
</ItemGroup>

Per rimuovere un riferimento al progetto, rimuovere l'elemento <ProjectReference> dal file di progetto.

Per altre informazioni sull'elemento, vedere Elementi comuni del ProjectReferenceprogetto MSBuild.

Aggiungere e rimuovere riferimenti ad assembly

È possibile aggiungere e rimuovere riferimenti ad assembly tramite il file di progetto. L'interfaccia della riga di comando .NET non fornisce comandi per aggiungere o rimuovere riferimenti ad assembly.

Per fare riferimento a un assembly .NET che non fa parte di un progetto o di un pacchetto, aggiungere un <Reference> elemento al file di progetto. Usare l'elemento <HintPath> per specificare il percorso relativo o assoluto dell'assembly:

<ItemGroup>
  <Reference Include="MyAssembly">
    <HintPath>lib/MyAssembly.dll</HintPath>
  </Reference>
</ItemGroup>

Per rimuovere un riferimento all'assembly, rimuovere il relativo <Reference> elemento dal file di progetto.

Per altre informazioni sull'elemento, vedere Elementi comuni del Referenceprogetto MSBuild.

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.

Vedere anche

  • Last updated on