Installieren und Verwalten von Paketen in Visual Studio mit dem NuGet-Paket-Manager

Über die Benutzeroberfläche des NuGet-Paket-Managers in Visual Studio für Mac können Sie auf einfache Weise NuGet-Pakete in Projekten und Projektmappen installieren, deinstallieren und aktualisieren.

Der Artikel gilt nur für Windows-Benutzer. Wenn Sie Visual Studio für Mac verwenden, finden Sie Informationen unter Einschließen eines NuGet-Pakets in Ihr Projekt.

Voraussetzungen

• Installieren Sie Visual Studio 2022 für Windows mit jedem . NET-bezogene Arbeitslast.

  Sie können die 2019 Community-Edition kostenlos von visualstudio.com installieren oder die Professional oder Enterprise Edition verwenden.

  Visual Studio 2017 oder höher enthält automatisch NuGet-Funktionen, wenn eine .NET-Workload installiert ist. Um sie einzeln in Visual Studio-Installer zu installieren, wählen Sie die Registerkarte "Einzelne Komponenten" aus, und wählen Sie dann "NuGet-Paket-Manager" unter Codetools aus.

  Wenn der NuGet-Paket-Manager in Visual Studio 2015 fehlt, aktivieren Sie >, und suchen Sie nach der Erweiterung für den NuGet-Paket-Manager. Wenn Sie das Installationsprogramm für Erweiterungen in Visual Studio nicht verwenden können, können Sie die Erweiterung direkt von https://dist.nuget.org/index.html herunterladen.

• Registrieren Sie sich für ein kostenloses Konto auf nuget.org, falls Sie noch kein Konto haben. Sie müssen das Konto bestätigen, bevor Sie ein Paket hochladen können.

Suchen und Installieren eines Pakets

Führen Sie die folgenden Schritte aus, um ein NuGet-Paket mit Visual Studio zu finden und zu installieren:

1. Laden Sie ein Projekt in Projektmappen-Explorer, und wählen Sie dann ">NuGet-Pakete verwalten" aus.

   Das Fenster NuGet-Paket-Manager wird geöffnet.

2. Wählen Sie die Registerkarte "Durchsuchen " aus, um Pakete nach Beliebtheit aus der aktuell ausgewählten Quelle anzuzeigen (siehe Paketquellen). Über das Suchfeld oben links können Sie ein bestimmtes Paket suchen. Wählen Sie ein Paket aus der Liste aus, um seine Informationen im rechten Bereich anzuzeigen, wodurch Sie eine zu installierende Version auswählen können.

   

3. Wählen Sie im rechten Bereich eine Version aus der Dropdownliste aus. Wenn Sie Vorabversionen in der Versionsliste einschließen möchten, wählen Sie "Prerelease einschließen" aus.

4. Um das NuGet-Paket zu installieren, wählen Sie " Installieren" aus. Möglicherweise werden Sie aufgefordert, Lizenzbedingungen zu akzeptieren oder aufgefordert, die Installation zu überprüfen.

   Visual Studio installiert das Paket und seine Abhängigkeiten im Projekt. Wenn die Installation abgeschlossen ist, werden die hinzugefügten Pakete auf der Registerkarte "Installiert" angezeigt. Sie können auch Pakete im Knoten "Abhängigkeitenpakete>" Ihres Projekts in Projektmappen-Explorer finden. Nachdem Sie ein Paket installiert haben, können Sie darauf im Projekt mit einer using Anweisung verweisen.

5. (Optional) NuGet verfügt über zwei Formate, in denen ein Projekt Pakete verwenden kann: PackageReference und packages.config. Wenn Sie das Standardformat festlegen möchten, wählen Sie "Extras>", " NuGet-Paket-Manager" aus, wählen Sie "Allgemein" aus, und wählen Sie dann das Standardpaketverwaltungsformat aus. Weitere Informationen finden Sie unter Auswählen des Standardpaketverwaltungsformats.

Deinstallieren eines Pakets

Führen Sie die folgenden Schritte aus, um die NuGet-Pakete abzurufen:

1. Laden Sie ein Projekt in Projektmappen-Explorer, wählen Sie ">NuGet-Pakete verwalten" aus, und wählen Sie dann die Registerkarte "Installiert" aus.

2. Wählen Sie das Paket aus, das im linken Bereich deinstalliert werden soll (verwenden Sie das Suchfeld , um es nach Bedarf zu finden), und wählen Sie dann " Deinstallieren " im rechten Bereich aus.

   

Aktualisieren eines Pakets

Führen Sie die folgenden Schritte aus, um die NuGet-Pakete abzurufen:

1. Laden Sie ein Projekt in Projektmappen-Explorer, und wählen Sie dann ">NuGet-Pakete verwalten" aus. Wählen Sie für Websiteprojekte zuerst den Ordner "Bin " aus.

2. Wählen Sie die Registerkarte Updates aus, um Pakete anzuzeigen, die über verfügbare Updates aus den ausgewählten Paketquellen verfügen. Wählen Sie Vorabversion einschließen aus, um Vorabversionspakete in die Liste „Update“ einzubeziehen.

3. Wählen Sie das Zu aktualisierende Paket aus. Wählen Sie im rechten Bereich die gewünschte Version aus der Dropdownliste aus, und wählen Sie dann "Aktualisieren" aus.

   

4. Für einige Pakete ist die Schaltfläche "Aktualisieren " deaktiviert und die folgende Meldung wird angezeigt: Implizit wird von einem SDK verwiesen. Um das Paket zu aktualisieren, aktualisieren Sie das SDK, zu dem es gehört. Diese Meldung gibt an, dass das Paket Teil eines größeren Frameworks oder SDK ist und nicht unabhängig aktualisiert werden kann. (Solche Pakete sind intern mit <IsImplicitlyDefined>True</IsImplicitlyDefined>markiert.) Beispielsweise ist Microsoft.NETCore.App Teil des .NET Core SDK, und die Paketversion ist nicht identisch mit der Version des von der Anwendung verwendeten Frameworks für die Runtime. Um eine neue Version des .NET Core herunterzuladen, aktualisieren Sie Ihre .NET Core-Installation. Weitere Informationen finden Sie unter .NET Core-Metapackagen und Versionsverwaltung. Dies gilt für die folgenden häufig verwendeten Pakete:

   • Microsoft.AspNetCore.All
   • Microsoft.AspNetCore.App
   • Microsoft.NETCore.App
   • NETStandard.Library

   

5. Wenn Sie mehrere Pakete auf ihre neuesten Versionen aktualisieren möchten, wählen Sie sie in der NuGet-Paketliste aus, und wählen Sie dann "Aktualisieren" aus.

6. Sie können auch ein einzelnes Paket auf der Registerkarte "Installiert " aktualisieren. Für diesen Fall können Sie auch eine Version und die Option "Vorabversion einschließen " auswählen.

Verwalten von Paketen für die Projektmappe

Die Verwaltung von Paketen für eine Projektmappe ist eine praktische Möglichkeit, mit mehreren Projekten gleichzeitig zu arbeiten.

1. Wählen Sie in Solution Manager eine Lösung aus, und wählen Sie dann "Tools>NuGet Package Manager>Verwalten von NuGet-Paketen für Lösung" aus.

2. Wählen Sie im Fenster "NuGet-Pakete für Projektmappen verwalten " die Projekte aus, die von den Vorgängen betroffen sind.

   

Registerkarte „Konsolidieren“

Entwickler sind in der Regel nicht davon begeistert, verschiedene Versionen desselben NuGet-Pakets in verschiedenen Projekten in derselben Projektmappe zu verwenden. Visual Studio ermöglicht Es Ihnen, eine allgemeine Version für Ihre NuGet-Pakete zu verwenden. Verwenden Sie dazu die Registerkarte " Konsolidieren " des NuGet-Paket-Managers , um zu ermitteln, wo Pakete mit unterschiedlichen Versionsnummern von verschiedenen Projekten in der Lösung verwendet werden.

In diesem Beispiel verwendet das ClassLibrary1-Projekt EntityFramework 6.2.0, während das ConsoleApp1-Projekt EntityFramework 6.1.0 verwendet. Führen Sie die folgenden Schritte aus, um Paketversionen zu konsolidieren:

1. Wählen Sie auf der Registerkarte "Konsolidieren " die Projekte aus, die in der Projektliste aktualisiert werden sollen.

2. Wählen Sie die Version aus, die für alle diese Projekte in der Versionsliste verwendet werden soll.

3. Wählen Sie Installieren aus.

   Der Paket-Manager installiert die ausgewählte Paketversion in allen ausgewählten Projekten. Danach erscheint das Paket nicht mehr auf der Registerkarte Konsolidieren.

Paketquellen

Visual Studio ignoriert die Reihenfolgen der Paketquellen und verwendet dabei das Paket aus einer beliebigen Quelle, die als erstes auf Anforderungen reagiert. Weitere Informationen finden Sie unter Wiederherstellen von Paketen. Informationen zum Laden eines Pakets aus einer bestimmten Quelle finden Sie in der Paketquellezuordnung.

Führen Sie die folgenden Schritte aus, um die NuGet-Pakete abzurufen:

1. Um die Quelle zu ändern, aus der Visual Studio Paketmetadaten lädt, wählen Sie eine Quelle aus der Paketquelleauswahl aus.

   

2. Um Ihre Paketquellen zu verwalten, wählen Sie das Symbol "Einstellungen " aus, oder wählen Sie " Extras>" aus.

   

3. Erweitern Sie im Fenster "Optionen " den Knoten "NuGet Package Manager ", und wählen Sie "Paketquellen" aus.

   

4. Um eine Quelle hinzuzufügen, wählen Sie + aus, bearbeiten Sie den Namen, geben Sie die URL oder den Pfad im Steuerelement Quelle ein, und wählen Sie Aktualisieren aus.

   Die Quelle wird nun in der Dropdownliste "Paketquelle " angezeigt.

5. Um eine Paketquelle zu ändern, markieren Sie sie, bearbeiten Sie die Felder Name und quelle, und wählen Sie Aktualisieren aus.

6. Um eine Paketquelle zu deaktivieren, deaktivieren Sie das Kontrollkästchen links neben dem Namen in der Liste.

7. Um eine Paketquelle zu entfernen, wählen Sie Sie aus, und klicken Sie dann auf die Schaltfläche X.

   Wenn eine Paketquelle nach dem Löschen wieder angezeigt wird, wird sie möglicherweise in einer -Datei auf Computer- oder Benutzerebene aufgelistet. Informationen zum Speicherort dieser Dateien finden Sie unter "Allgemeine NuGet-Konfigurationen". Entfernen Sie die Paketquelle in den Dateien, indem Sie sie manuell bearbeiten oder den Befehl "Nuget-Quellen" verwenden.

Steuerelement "NuGet Package Manager"-Optionen

Wenn Sie ein Paket auswählen, zeigt der NuGet-Paket-Manager ein erweitertes Optionssteuerelement unterhalb der Versionsauswahl an. Beachten Sie, dass bei einigen Projekttypen nur die Option Vorschaufenster anzeigen angegeben ist.

Diese Optionen werden in den folgenden Abschnitten erläutert.

Installations- und Aktualisierungsoptionen

Diese Optionen sind nur für bestimmte Projekttypen verfügbar:

• Mit Abhängigkeitsverhalten wird konfiguriert, wie NuGet entscheidet, welche Versionen von abhängigen Paketen installiert werden sollen: VM1 umfasst die folgenden Einstellungen:

  • Die Option Abhängigkeiten ignorieren überspringt die Installation von Abhängigkeiten, was typischerweise zu einer Unterbrechung des zu installierenden Pakets führt.
  • Niedrigste [Standard] installiert die Abhängigkeit mit der minimalen Versionsnummer, die den Anforderungen des primär ausgewählten Pakets entspricht.
  • Höchster Patch installiert die Version mit den gleichen Haupt- und Nebenversionsnummern, aber mit der höchsten Patchnummer. Wenn beispielsweise die Version 1.2.2 angegeben wird, wird die höchste Version, die mit 1.2 beginnt, installiert.
  • Höchste kleinere installiert die Version mit der gleichen Hauptversionsnummer, aber der höchsten Nebenversions und Patchnummer. Wenn die Version 1.2.2 angegeben wird, wird die höchste Version, die mit 1 beginnt, installiert.
  • Höchste installiert die höchste verfügbare Version des Pakets.

• Aktion bei Dateikonflikt gibt an, wie NuGet Pakete behandeln soll, die bereits im Projekt oder auf dem lokalen Computer vorhanden sind: VM1 umfasst die folgenden Einstellungen:

  • Aufforderung weist NuGet an, zu fragen, ob bestehende Pakete beibehalten oder überschrieben werden sollen.
  • Alle ignorieren weist NuGet an, das Überschreiben vorhandener Pakete zu überspringen.
  • Alle überschreiben weist NuGet an, alle vorhandenen Pakete zu überschreiben.

Deinstallationsoptionen

Diese Optionen sind nur für bestimmte Projekttypen verfügbar:

• Abhängigkeiten entfernen: Wenn diese Option ausgewählt ist, werden alle abhängigen Pakete entfernt, wenn nicht an anderer Stelle im Projekt auf sie verwiesen wird.

• Deinstallation erzwingen, auch wenn Abhängigkeiten davon bestehen: Wenn diese Option ausgewählt ist, wird ein Paket deinstalliert, auch wenn darauf im Projekt noch verwiesen wird. Dies wird in der Regel in Kombination mit Abhängigkeiten entfernen verwendet, um ein Paket und alle von ihm installierten Abhängigkeiten zu entfernen. Die Verwendung dieser Option kann jedoch zu fehlerhaften Verweisen im Projekt führen. In solchen Fällen müssen Sie möglicherweise diese anderen Pakete neu installieren.

Zugehörige Videos

• Installieren und Verwenden eines NuGet-Pakets mit Visual Studio
• Auf Channel 9 und auf YouTube finden Sie weitere Videos zu NuGet.

Siehe auch

Weitere Informationen zu den Partitionen finden Sie in den folgenden Artikeln:

• Was ist NuGet?
• Workflow der Nutzung von Paketen
• Suchen und Auswählen von Paketen
• Paketverweise in Projektdateien
• Installieren und Verwenden eines Pakets mithilfe der .NET CLI.