Voraussetzungen für das Portieren von Code

Nehmen Sie die erforderlichen Änderungen beim Erstellen vor und führen Sie eine .NET-Anwendung aus, bevor Sie mit dem Portieren Ihres Codes beginnen. Diese Änderungen können beim Erstellen und Ausführen einer .NET Framework-Anwendung ausgeführt werden.

Von Bedeutung

Der .NET-Upgrade-Assistent ist offiziell veraltet. Verwenden Sie stattdessen den GitHub Copilot-Modernisierungschat-Agent , der in Visual Studio 2026 und Visual Studio 2022 17.14.16 oder höher enthalten ist. Dieser Agent analysiert Ihre Projekte und Abhängigkeiten, erstellt einen schrittweisen Migrationsplan mit gezielten Empfehlungen und automatisierten Codefixes und führt einen Commit für jede Änderung durch, sodass Sie ein Rollback ausführen können. Es automatisiert allgemeine Portierungsaufgaben – Aktualisieren von Projektdateien, Ersetzen veralteter APIs und Beheben von Buildproblemen – sodass Sie schneller mit weniger manuellem Aufwand modernisieren können.

Upgrade auf erforderliche Werkzeuge

Führen Sie ein Upgrade auf eine Version von MSBuild/Visual Studio durch, die die Version von .NET unterstützt, auf die Sie abzielen. Weitere Informationen finden Sie unter Versionsverwaltungsbeziehung zwischen .NET SDK, MSBuild und VS .

Aktualisieren der .NET Framework-Zielversion

Es wird empfohlen, Ihre .NET Framework-App auf Version 4.7.2 oder höher auszurichten. Dadurch wird die Verfügbarkeit der neuesten API-Alternativen für Fälle sichergestellt, in denen .NET Standard vorhandene APIs nicht unterstützt.

Führen Sie für jedes projekt, das Sie portieren möchten, die folgenden Schritte in Visual Studio aus:

  1. Klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie "Eigenschaften" aus.
  2. Wählen Sie im Dropdownmenü "Target Framework" .NET Framework 4.7.2 aus.
  3. Kompilieren Sie das Projekt erneut.

Da Ihre Projekte jetzt auf .NET Framework 4.7.2 abzielen, verwenden Sie diese Version von .NET Framework als Basis für das Portieren von Code.

Ändern des PackageReference-Formats

Konvertieren Sie alle Verweise in das PackageReference-Format .

In das Projektformat im SDK-Stil konvertieren

Konvertieren Sie Ihre Projekte in das SDK-Format.

Aktualisieren von Abhängigkeiten

Aktualisieren Sie Abhängigkeiten auf ihre neueste verfügbare Version und auf .NET Standard-Version, sofern möglich.

Nächste Schritte