Migrace z ASP.NET Core 3.0 na 3.1

  • Článek

Autor: 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 verze sady .NET Core SDK v global.json

Pokud spoléháte na global.json soubor, který má cílit na konkrétní verzi sady .NET Core SDK, aktualizujte version vlastnost na nainstalovanou verzi 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íčky

V souboru projektu aktualizujte atribut odkazu Version na každý Microsoft.AspNetCore.* balíček na verzi 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/aspnet:3.1

Implementace SameSite atributů pro http cookiese změnily mezi ASP.NET Core 3.0 a 3.1. Akce, které se mají provést, najdete v následujících zdrojích informací:

Publikování pomocí sady Visual Studio

.pubxml V souboru aktualizujte TargetFramework na verzi 3.1:

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

Kontrola zásadních změn

Projděte si zásadní změny 3.0-to-3.1 napříč .NET Core, ASP.NET Core a Entity Framework Core při zásadních změnách migrace z verze 3.0 na 3.1.

Volitelné změny

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

Použití pomocné rutiny značek součástí

ASP.NET Core 3.1 zavádí pomocné rutiny Component značek. Pomocná rutina značky může v projektu nahradit metodu RenderComponentAsync<TComponent> pomocné rutiny 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 najdete v tématu Prerender a integrace komponent ASP.NET CoreRazor.

modul ASP.NET Core (ANCM)

Pokud ASP.NET Core Module (ANCM) nebyla vybraná komponenta při instalaci sady Visual Studio nebo pokud byla v systému nainstalována předchozí verze ANCM, stáhněte si nejnovější instalační program balíčku hostingu .NET Core (přímý stažení) a spusťte instalační program. Další informace naleznete v tématu Hosting Bundle.