Migrieren von ASP.net Core 3,1 zu 5,0Migrate from ASP.NET Core 3.1 to 5.0

Von Scott AddieBy Scott Addie

In diesem Artikel wird erläutert, wie ein vorhandenes ASP.net Core 3,1-Projekt auf ASP.net Core 5,0 aktualisiert wird.This article explains how to update an existing ASP.NET Core 3.1 project to ASP.NET Core 5.0.

Wichtig

ASP.net Core 5,0 befindet sich derzeit in der Vorschau Phase.ASP.NET Core 5.0 is currently in preview.

VoraussetzungenPrerequisites

Aktualisieren der .NET Core SDK-Version in „global.json“Update .NET Core SDK version in global.json

Wenn Sie sich für eine bestimmte .net Core SDK Version auf eine global.jsin der Datei verlassen, aktualisieren Sie die version -Eigenschaft auf die installierte Version von .net 5,0 SDK.If you rely upon a global.json file to target a specific .NET Core SDK version, update the version property to the .NET 5.0 SDK version that's installed. Zum Beispiel:For example:

{
  "sdk": {
-    "version": "3.1.200"
+    "version": "5.0.100-preview.6.20318.15"
  }
}

Aktualisieren des Ziel FrameworksUpdate the target framework

Aktualisieren Sie in der Projektdatei den zielframeworkmoniker (TFM) auf net5.0 :In the project file, update the Target Framework Moniker (TFM) to net5.0:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>

</Project>

Aktualisieren von PaketverweisenUpdate package references

Aktualisieren Sie in der Projektdatei die Microsoft.AspNetCore.* einzelnen Microsoft.Extensions.* Attribute und das Attribut des Paket Verweises Version auf 5.0.0 oder höher.In the project file, update each Microsoft.AspNetCore.* and Microsoft.Extensions.* package reference's Version attribute to 5.0.0 or later. Zum Beispiel:For example:

<ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.2" />
-    <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="3.1.2" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="5.0.0-preview.6.20312.15" />
+    <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="5.0.0-preview.6.20305.6" />
</ItemGroup>

Aktualisieren von Docker-ImagesUpdate Docker images

Aktualisieren Sie die dockerfile FROM -Anweisungen und-Skripts für apps, die Docker verwenden.For apps using Docker, update your Dockerfile FROM statements and scripts. Verwenden Sie ein Basis Image, das den ASP.net Core 5,0-Lauf Zeit Modul einschließt.Use a base image that includes the ASP.NET Core 5.0 runtime. Beachten Sie den folgenden docker pull Befehls Unterschied zwischen ASP.net Core 3,1 und 5,0:Consider the following docker pull command difference between ASP.NET Core 3.1 and 5.0:

- docker pull mcr.microsoft.com/dotnet/core/aspnet:3.1
+ docker pull mcr.microsoft.com/dotnet/aspnet:5.0

Im Rahmen der Umstellung auf ".net" als Produktname wurden die Docker-Images aus den mcr.microsoft.com/dotnet/core Depots in verschoben mcr.microsoft.com/dotnet .As part of the move to ".NET" as the product name, the Docker images moved from the mcr.microsoft.com/dotnet/core repositories to mcr.microsoft.com/dotnet. Weitere Informationen finden Sie unter dotnet/dotnet-docker # 1939.For more information, see dotnet/dotnet-docker#1939.

Wichtige Änderungen überprüfenReview breaking changes

Grundlegende Änderungen von .net Core 3,1 auf .net 5,0 finden Sie unter Breaking Changes for Migration from Version 3,1 to 5,0.For breaking changes from .NET Core 3.1 to .NET 5.0, see Breaking changes for migration from version 3.1 to 5.0. ASP.net Core und Entity Framework Core sind auch in der Liste enthalten.ASP.NET Core and Entity Framework Core are also included in the list.