Migrace z ASP.NET Core 3.0 na 3.1

Scott Addie

Tento článek vysvětluje, jak aktualizovat existující projekt ASP.NET Core 3.0 na ASP.NET Core 3.1.

Požadavky

Aktualizace .NET Core SDK verze v global.json

Pokud při cílení na global.js verzi .NET Core SDK spoléháte na soubor , aktualizujte vlastnost na nainstalovanou verzi version sady SDK 3.1. Příklad:

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

Aktualizace cílové architektury

V souboru projektu aktualizujte moniker cílové architektury (TFM) na netcoreapp3.1 :

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

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

</Project>

Aktualizace odkazů na balíček

V souboru projektu aktualizujte atribut každého odkazu Microsoft.AspNetCore.* na Version balíček na 3.1.0 nebo novější. Příklad:

<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>

Aktualizace imagí Dockeru

Pro aplikace používající Docker použijte základní image, která zahrnuje ASP.NET Core 3.1. Příklad:

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

React ke změnám cookie SameSite

Implementace SameSite atributů pro http s se mezi ASP.NET Core cookie 3.0 a 3.1 změnily. Akce, které je třeba provádět, najdete v následujících zdrojích informací:

• Práce s weby SameSite cookie v ASP.NET Core
• aspnet/Announcements#390
• Připravované změny cookie SameSite v ASP.NET a ASP.NET Core

Publikování pomocí sady Visual Studio

V souboru .pubxml aktualizujte TargetFramework na 3.1:

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

Kontrola změn s rozbíjením

Informace o rozbíjení změn z verze 3.0 na verzi 3.1 v .NET Core, ASP.NET Core a Entity Framework Core si můžete prolomit v případě migrace z verze 3.0 na verzi 3.1.

Volitelné změny

Následující změny jsou volitelné.

Použití pomocníka pro značky komponent

ASP.NET Core 3.1 zavádí Component pomocná pomocníka značek. Pomocná metoda značek může v RenderComponentAsync<TComponent> projektu nahradit pomocná metoda Blazor HTML. Příklad:

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

Další informace naleznete v tématu Předběžné vykreslení a integrace ASP.NET Core Razor komponent.