Freigeben über

Verwalten von Paketabhängigkeiten in .NET-Anwendungen

In diesem Artikel wird erläutert, wie Paketabhängigkeiten durch Bearbeiten der Projektdatei oder mithilfe der CLI hinzugefügt und entfernt werden.

Das <PackageReference>-Element

Das <PackageReference> Projektdateielement weist die folgende Struktur auf:

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

Das Include Attribut gibt die ID des Pakets an, das dem Projekt hinzugefügt werden soll. Das Version Attribut gibt die abzurufende Version an. Versionen werden gemäß NuGet-Versionsregeln angegeben.

Verwenden Sie Bedingungen, um eine Abhängigkeit hinzuzufügen, die nur in einem bestimmten Ziel verfügbar ist, wie im folgenden Beispiel gezeigt:

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

Die Abhängigkeit im vorherigen Beispiel ist nur gültig, wenn der Build für dieses angegebene Ziel erfolgt. $(TargetFramework) in der Bedingung ist eine MSBuild-Eigenschaft, die im Projekt festgelegt wird. Für die meisten gängigen .NET-Anwendungen müssen Sie dies nicht tun.

Hinzufügen und Entfernen von Abhängigkeiten

Sie können Abhängigkeiten hinzufügen und entfernen, indem Sie die Projektdatei oder .NET CLI-Befehle ändern.

Bearbeiten der Projektdatei

Um eine Abhängigkeit hinzuzufügen, fügen Sie ein <PackageReference> Element innerhalb eines <ItemGroup> Elements hinzu. Sie können zu einer vorhandenen <ItemGroup> hinzufügen oder eine neue erstellen.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

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

</Project>

Um eine Abhängigkeit zu entfernen, entfernen Sie das <PackageReference> Element aus der Projektdatei.

Verwenden Sie die CLI

Um eine Abhängigkeit hinzuzufügen, führen Sie den dotnet package add Befehl aus, wie im folgenden Beispiel gezeigt. (Wenn Sie eine SDK-Version von .NET 9 oder einer früheren Version verwenden, verwenden Sie stattdessen das dotnet add package Formular.)

dotnet package add Microsoft.EntityFrameworkCore

Um eine Abhängigkeit zu entfernen, führen Sie den dotnet package remove Befehl aus, wie im folgenden Beispiel gezeigt. (Wenn Sie eine SDK-Version von .NET 9 oder einer früheren Version verwenden, verwenden Sie stattdessen das dotnet remove package Formular.)

dotnet package remove Microsoft.EntityFrameworkCore

Tipps

  • Schließen Sie keine Eingaben für den Wiederherstellungsvorgang in der .targets- oder .props-Datei eines referenzierten Pakets ein. Diese Eingaben können PackageReference Elemente, ExcludeAssets Attribute, die zu verwendenden NuGet-Feeds oder andere NuGet-Konfigurationen umfassen. Die .targets and .props Dateien aus Paketen werden erst verwendet, nachdem die NuGet-Wiederherstellung abgeschlossen ist. Alles, was für die Wiederherstellung erforderlich ist, muss sich in der Projektdatei oder ZIELdatei des Projekts befinden, nicht in einer Paketabhängigkeit.

  • Wenn Sie ASP.NET APIs in einer Konsolenanwendung oder Klassenbibliothek verwenden möchten, fügen Sie Ihrer Projektdatei ein FrameworkReference-Element hinzu:

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

    Weitere Informationen finden Sie unter Verwenden des ASP.NET core shared framework.

Siehe auch

  • Last updated on