Migrieren von ASP.NET Core 3.0 zu 3.1

Ist diese Seite hilfreich?

Haben Sie weiteres Feedback für uns?

Feedback wird an Microsoft gesendet: Wenn Sie auf die Sendeschaltfläche klicken, wird Ihr Feedback verwendet, um Microsoft-Produkte und -Dienste zu verbessern. Datenschutzrichtlinie

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

Visual Studio

• Visual Studio 2019 Version 16.4 oder höher mit der Workload ASP.NET und Webentwicklung.

• .NET Core 3.1 SDK

Visual Studio Code

• Visual Studio Code
• C# für Visual Studio Code (neueste Version)
• .NET Core 3.1 SDK

In den Visual Studio Code-Anweisungen wird die .NET Core-CLI für ASP.NET Core-Entwicklungsfunktionen wie die Projekterstellung verwendet. Sie können diesen Anweisungen auf jeder beliebigen Plattform (macOS, Linux oder Windows) und in jedem beliebigen Code-Editor folgen. Kleinere Änderungen sind möglicherweise erforderlich, wenn Sie ein anderes Programm als Visual Studio Code verwenden. Weitere Informationen zum Installieren von Visual Studio Code unter macOS finden Sie unter Visual Studio Code unter macOS.

Visual Studio für Mac

• Visual Studio für Mac, Version 8.4 oder höher
• .NET Core 3.1 SDK

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

React an SameSite-Änderungen cookie

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:

• Arbeiten mit SameSite cookiein ASP.NET Core
• aspnet/Announcements#390
• Bevorstehende SameSite-Änderungen cookie in ASP.NET und ASP.NET Core

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.