Dela via

Hantera paketberoenden i .NET-program

Den här artikeln beskriver hur du lägger till och tar bort paketberoenden genom att redigera projektfilen eller med hjälp av CLI.

<PackageReference-elementet>

Projektfilelementet <PackageReference> har följande struktur:

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

Attributet Include anger ID för paketet som ska läggas till i projektet. Attributet Version anger vilken version som ska hämtas. Versioner anges enligt NuGet-versionsregler.

Använd villkor för att lägga till ett beroende som endast är tillgängligt i ett specifikt mål, enligt följande exempel:

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

Beroendet i föregående exempel är endast giltigt om bygget sker för det angivna målet. $(TargetFramework) i villkoret är en MSBuild-parameter som anges i projektet. För de vanligaste .NET-programmen behöver du inte göra detta.

Lägga till och ta bort beroenden

Du kan lägga till och ta bort beroenden genom att redigera projektfilen eller via .NET CLI-kommandon .

Redigera projektfilen

Lägg till ett beroende genom att lägga till ett <PackageReference> objekt i ett <ItemGroup> element. Du kan lägga till i en befintlig <ItemGroup> eller skapa en ny.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

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

</Project>

Ta bort ett beroende genom att ta bort objektet <PackageReference> från projektfilen.

Använda CLI

Om du vill lägga till ett beroende kör dotnet package add du kommandot enligt följande exempel. (Om du använder en SDK-version av .NET 9 eller tidigare använder du formuläret dotnet add package i stället.)

dotnet package add Microsoft.EntityFrameworkCore

Om du vill ta bort ett beroende kör dotnet package remove du kommandot, som du ser i följande exempel. (Om du använder en SDK-version av .NET 9 eller tidigare använder du formuläret dotnet remove package i stället.)

dotnet package remove Microsoft.EntityFrameworkCore

Råd

  • Inkludera inte indata till återställningsåtgärden i .targets - eller .props-filen i ett refererat paket. Dessa indata kan innehålla PackageReference objekt, ExcludeAssets attribut, NuGet-feeds som ska användas eller annan NuGet-konfiguration. .targets- och .props-filerna från paket används inte förrän NuGet-återställningen har slutförts. Allt som behövs för återställning måste finnas i projektfilen eller .targets-filen för själva projektet, inte i ett paketberoende.

  • Om du vill använda ASP.NET API:er i ett konsolprogram eller klassbibliotek lägger du till ett FrameworkReference-objekt i projektfilen:

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

    Mer information finns i Använda det delade ramverket ASP.NET Core.

Se även