Aktualisieren von Projekten mit dem .NET-Upgrade-Assistenten

Der Schwerpunkt dieses Artikels liegt darin, die grundlegenden Schritte zum Upgrade eines Projekts mit dem .NET-Upgrade-Assistenten bereitzustellen. Dazu müssen Sie das Upgrade initiieren und die Ergebnisse überprüfen. Je nachdem, wie komplex Ihr Projekt ist, müssen Sie möglicherweise manuelle Aktualisierungen an Ihrem Code ausführen.

Einige Projekttypen weisen spezifische Anleitungen zum Upgrade auf. Weitere Informationen finden Sie unter "Unterstützte Projekttypen".

Voraussetzungen

• Informationen zu Visual Studio finden Sie unter Installieren des .NET-Upgrade-Assistenten – Visual Studio-Erweiterung
• Informationen zum .NET Global Tool finden Sie unter Installieren des .NET-Upgrade-Assistenten – .NET Global Tool

Aktualisieren eines Projekts in Visual Studio

Führen Sie die folgenden Schritte aus, um ein Projekt in Visual Studio zu aktualisieren.

1. Sichern Sie Ihren Code.

2. Öffnen Sie Visual Studio.

3. Öffnen Sie ein Projekt oder eine Projektmappe.

4. Klicken Sie im Projektmappen-Explorer-Fenster mit der rechten Maustaste auf das Projektupgrade>.

   

5. Wählen Sie auf der Registerkarte "Upgrade " die entsprechenden Upgradeoptionen aus.

   Basierend auf dem Projekttyp und der Zielframeworkversion werden verschiedene Optionen vorgestellt. Die folgende Abbildung zeigt zwei Optionen beim Upgrade eines Windows Forms für .NET Framework-Projekts. Diese Optionen werden beim Upgrade eines .NET-Projekts nicht angezeigt:

   

   Wählen Sie in diesem Beispiel "Projekt aktualisieren" auf eine neuere .NET-Version aus.

6. Wählen Sie aus, wie Sie das Upgrade durchführen möchten. Wählen Sie "Direktes Projektupgrade" und dann "Weiter" aus.

   Einige Projekte präsentieren Ihnen möglicherweise nur eine einzige Option. Weitere Informationen zu diesen Optionen finden Sie unter Ausführen des Upgrades.

   

7. Wählen Sie das Zielframework aus, z . B. .NET 8.0. Wählen Sie anschließend Weiter aus.

   

8. Wählen Sie die zu aktualisierenden Komponenten aus, und wählen Sie dann " Upgrade" aus.

   

9. Nach Abschluss des Upgrades wird eine Liste der verarbeiteten Elemente angezeigt.

   

Jedes vom Upgrade verarbeitete Artefakt wird zusammen mit seinem Status aufgelistet. Weitere Informationen finden Sie unter Upgradeergebnisse.

Upgrade eines Projekts von der CLI

Führen Sie die folgenden Schritte aus, um ein Projekt mithilfe des Terminals zu aktualisieren. Das .NET Global Tool ist ein interaktives Tool, das Sie durch die Upgradeoptionen führt. Verwenden Sie die NACH-OBEN - und NACH-UNTEN-TASTE , um die hervorgehobene Option zu ändern, und drücken Sie die EINGABETASTE , um die Option auszuwählen. Auf jedem Bildschirm werden Optionen zum Konfigurieren des Upgrades angezeigt.

1. Sichern Sie Ihren Code.

2. Öffnen Sie ein Terminal, und navigieren Sie zu dem Ordner, der die Projektmappe oder das Projekt enthält, die Sie aktualisieren möchten.

3. Führen Sie den upgrade-assistant upgrade Befehl aus, um das Tool zu starten.

   Sie werden gefragt, was Sie aktualisieren möchten. Je nachdem, was erkannt wird, werden einige Optionen möglicherweise automatisch angewendet oder fehlen vollständig.

   

4. Wenn mehrere Projekte gefunden werden, wählen Sie eines der Projekte aus, und drücken Sie die EINGABETASTE.

   Aktualisieren Sie Projekte in der Reihenfolge ihrer Abhängigkeit. Die vorherige Abbildung zeigt z. B. zwei Projekte: MatchingGame und MatchingGame.Logic. MatchingGame ist abhängig von MatchingGame.Logic, daher MatchingGame.Logic sollte zuerst ein Upgrade durchgeführt werden.

5. Wenn Sie die Option zum Ändern des Upgradetyps haben, wählen Sie einen aus, und drücken Sie die EINGABETASTE. Wenn nur eine Option verfügbar war, wäre sie automatisch ausgewählt worden.

   Weitere Informationen zu diesen Optionen finden Sie unter Ausführen des Upgrades.

   Tipp

   Wenn Sie Ihren Code gesichert haben, ist es sicher, ein direktes Projektupgrade auszuwählen.

6. Wählen Sie ein Zielframework aus, z . B. .NET 8.0, und drücken Sie die EINGABETASTE.

7. Die letzte Eingabeaufforderung ist eine Bestätigung und zeigt alle ausgewählten Optionen an. Drücken Sie die EINGABETASTE , um das Upgrade zu starten.

   

8. Nach Abschluss des Upgrades wird eine Zusammenfassung angezeigt.

   

Zugehöriger Inhalt

• Was ist der .NET-Upgrade-Assistent?
• Was ist Codeanalyse mit dem .NET-Upgrade-Assistenten?
• Analysieren von Projekten mit dem .NET-Upgrade-Assistenten