Installieren des .NET-Upgrade-Assistenten
Der .NET-Upgrade-Assistent kann als Visual Studio-Erweiterung oder als .NET-Befehlszeilentool installiert werden. Bei der Installation als Visual Studio-Erweiterung können geladene Projekte über das Kontextmenü aktualisiert werden. Die .NET-Befehlszeilen-Toolversion bietet eine interaktive Oberfläche, die schrittweise durchlaufen werden kann. Weitere Informationen zum Installieren des Tools finden Sie unter Übersicht über den .NET-Upgrade-Assistenten.
Voraussetzungen
- Windows-Betriebssystem
- Visual Studio 2022, Version 17.1 oder höher
- .NET SDK für das Befehlszeilentool
Installieren der Visual Studio-Erweiterung
Der .NET-Upgrade-Assistent kann als Visual Studio-Erweiterung installiert werden, mit der Sie ein Upgrade eines geöffneten Projekts durchführen können. Führen Sie die folgenden Schritte aus, um den .NET-Upgrade-Assistenten in Visual Studio zu installieren. Alternativ dazu können Sie die Erweiterung auch aus dem Visual Studio Marketplace herunterladen und installieren.
Wenn Visual Studio geöffnet ist, wählen Sie das Menüelement Erweiterungen>Erweiterungen verwalten, wodurch das Fenster Erweiterungen verwalten geöffnet wird.
Geben Sie Upgrade in das Sucheingabefeld des Fensters Erweiterungen verwalten ein.
Wählen Sie das Element .NET-Upgrade-Assistent und dann Herunterladen aus.
Nachdem die Erweiterung heruntergeladen wurde, schließen Sie Visual Studio. Dadurch wird die Installation der Erweiterung gestartet:
Wählen Sie Ändern aus, und folgen Sie den Anweisungen zum Installieren der Erweiterung.
Installieren des globalen .NET-Tools
Der .NET-Upgrade-Assistent ist auch als globales .NET-Tool verfügbar. Sie können das Tool mit dem folgenden Befehl installieren:
dotnet tool install -g upgrade-assistant
Da der .NET-Upgrade-Assistent als .NET-Tool installiert ist, kann er auf ähnliche Weise ganz einfach aktualisiert werden, indem Sie Folgendes ausführen:
dotnet tool update -g upgrade-assistant
Wichtig
Die Installation dieses Tools schlägt möglicherweise fehl, wenn Sie zusätzliche NuGet-Feedquellen konfiguriert haben. Verwenden Sie den --ignore-failed-sources-Parameter, um diese Fehler als Warnungen statt als Fehler zu behandeln:
dotnet tool install -g --ignore-failed-sources upgrade-assistant
Wenn Sie ein Upgrade für Projekte mit WCF-Komponenten durchführen, verwenden Sie die ältere Version des CLI-Tools. Weitere Informationen finden Sie unter Installieren (Legacyversion).
