Auf Englisch lesen

Freigeben über


Upgrade auf eine neue .NET-Version

Neue .NET-Versionen werden jedes Jahr veröffentlicht. Viele Entwickler beginnen mit dem Upgradeprozess, sobald die neue Version verfügbar ist, während andere warten, bis die von ihnen verwendete Version nicht mehr unterstützt wird. Beim Upgrade-Prozess sind mehrere Aspekte zu beachten.

Häufige Gründe für das Upgrade auf eine neue .NET-Version:

  • Die aktuell verwendete .NET-Version wird nicht mehr unterstützt
  • Die neue Version unterstützt ein neues Betriebssystem
  • Die neue Version verfügt über eine wichtige API, Leistung oder Sicherheitsfunktion

Upgrade der Entwicklungsumgebung

Zum Upgrade auf eine neue .NET-Version ist das .NET SDK die primäre zu installierende Komponente. Sie enthält eine aktualisierte .NET CLI, Buildsystem und Laufzeitversion.

Die .NET-Website bietet Installationsprogramme und Archive, die Sie auf alle unterstützten Betriebssysteme und Architekturen herunterladen und verwenden können.

Einige Betriebssysteme verfügen über einen Paket-Manager, mit dem Sie auch eine neue .NET-Version installieren können, was Sie vielleicht bevorzugen.

Visual Studio installiert automatisch neue .NET SDK-Versionen. Für Visual Studio-Benutzer reicht es aus, ein Upgrade auf eine neuere Visual Studio-Version durchzuführen.

Quellcode aktualisieren

Die einzige erforderliche Änderung, um eine Anwendung zu aktualisieren, ist die Aktualisierung der TargetFramework-Eigenschaft in einer Projektdatei auf die neuere .NET-Version.

So funktioniert's:

  • Öffnen Sie die Projektdatei (die *.csproj-, *.vbproj- oder *.fsproj-Datei).
  • Ändern Sie den Wert der <TargetFramework>-Eigenschaft beispielsweise von net6.0 zu net8.0.
  • Das gleiche Muster gilt für die <TargetFrameworks>-Eigenschaft, wenn sie verwendet wird.

Der Upgrade-Assistent kann diese Änderungen automatisch vornehmen.

Der nächste Schritt besteht darin, das Projekt (oder die Projektmappe) mit dem neuen SDK zu erstellen. Wenn zusätzliche Änderungen erforderlich sind, gibt das SDK Warnungen und Fehler aus, die Sie anleiten.

Möglicherweise müssen Sie dotnet workload restore ausführen, um Workloads mit der neuen SDK-Version wiederherzustellen.

Weitere Ressourcen:

Aktualisieren von Continuous Integration (CI)

CI-Pipelines folgen einem ähnlichen Updateprozess wie Projektdateien und Dockerfiles. In der Regel können Sie CI-Pipelines aktualisieren, indem Sie nur Versionswerte ändern.

Update der Hostingumgebung

Es gibt viele Muster, die für Hostinganwendungen verwendet werden. Wenn die Hostingumgebung die .NET-Laufzeit enthält, muss die neue Version der .NET-Laufzeit installiert werden. Unter Linux müssen Abhängigkeiten installiert werden, die sich jedoch in der Regel zwischen den verschiedenen .NET-Versionen nicht ändern.

Bei Containern müssen FROM Anweisungen geändert werden, um neue Versionsnummern einzuschließen.

Im folgenden Dockerfile-Beispiel wird das Abrufen eines ASP.NET Core 9.0-Images veranschaulicht.

FROM mcr.microsoft.com/dotnet/aspnet:9.0

In einem Clouddienst wie Azure App Service ist eine Konfigurationsänderung erforderlich.