Migrieren von ASP.NET Core 3.0 zu 3.1

Von Scott Addie

In diesem Artikel wird erläutert, wie Sie ein vorhandenes ASP.NET Core 3.0-Projekt auf ASP.NET Core 3.1 aktualisieren.

Voraussetzungen

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

Wenn Sie eine global.json-Datei als Ziel für eine bestimmte .NET Core SDK-Version verwenden, version aktualisieren Sie die -Eigenschaft auf die installierte 3.1 SDK-Version. Beispiel:

{
  "sdk": {
-    "version": "3.0.101"
+    "version": "3.1.101"
  }
}

Aktualisieren des Zielframework

Aktualisieren Sie in der Projektdatei den Zielframeworkmoniker (Target Framework Moniker, TFM) innetcoreapp3.1:

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

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

</Project>

Aktualisieren von Paketverweisen

Aktualisieren Sie in der Projektdatei das Microsoft.AspNetCore.* -Attribut jedes Paketverweises Version auf 3.1.0 oder höher. Beispiel:

<ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.0.0" Condition="'$(Configuration)' == 'Debug'" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.1" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.1.1" Condition="'$(Configuration)' == 'Debug'" />
</ItemGroup>

Aktualisieren von Docker-Images

Verwenden Sie für Apps, die Docker verwenden, ein Basisimage, das ASP.NET Core 3.1 enthält. Beispiel:

docker pull mcr.microsoft.com/dotnet/aspnet:3.1

Die SameSite Attributimplementierung für HTTP-s cookiewurde zwischen ASP.NET Core 3.0 und 3.1 geändert. Informationen zu den durchzuführenden Aktionen finden Sie in den folgenden Ressourcen:

Veröffentlichen mit Visual Studio

Aktualisieren Sie .pubxml in der Datei auf TargetFramework 3.1:

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

Überprüfen von Breaking Changes

Informationen zu breaking changes in .NET Core, ASP.NET Core und Entity Framework Core finden Sie unter Breaking Changes für die Migration von Version 3.0 zu 3.1.

Optionale Änderungen

Die folgenden Änderungen sind optional.

Verwenden des Hilfselements für Komponententags

ASP.NET Core 3.1 führt ein Component Tag-Hilfs hilfser. Das Tag helper kann die RenderComponentAsync<TComponent> HTML-Hilfsmethode in einem Projekt Blazor ersetzen. Beispiel:

- @(await Html.RenderComponentAsync<Counter>(RenderMode.ServerPrerendered, new { IncrementAmount = 10 }))
+ <component type="typeof(Counter)" render-mode="ServerPrerendered" param-IncrementAmount="10" />

Weitere Informationen finden Sie unter Prerendering und Integrieren von Razor-Komponenten in ASP.NET Core.

ASP.NET Core Module (ANCM)

Wenn das ASP.NET Core-Modul (ANCM) keine ausgewählte Komponente war, als Visual Studio installiert wurde, oder wenn eine frühere Version des ANCM auf dem System installiert war, laden Sie den neuesten Installer für das .NET Core-Hostingpaket herunter (direkter Download), und führen Sie das Installationsprogramm aus. Weitere Informationen finden Sie unter Hosting Bundle.