Migrace z ASP.NET Core 3.0 na 3.1

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

Visual Studio

• Sada Visual Studio 2019 16.4 nebo novější se sadou funkcí Vývoj pro ASP.NET a web
• Sada .NET Core 3.1 SDK

Visual Studio Code

• Visual Studio Code
• Jazyk C# pro Visual Studio Code (nejnovější verze)
• Sada .NET Core 3.1 SDK

V pokynech pro Visual Studio Code se pro vývojové funkce ASP.NET Core, jako je vytvoření projektu, používá .NET CLI. Podle těchto pokynů můžete postupovat na libovolné platformě (macOS, Linux nebo Windows) a v jakémkoli editoru kódu. Pokud použijete jiný editor než Visual Studio Code, možná budete muset provést menší změny. Další informace o instalaci Visual Studio Code v systému macOS najdete v tématu Visual Studio Code v systému macOS.

Visual Studio pro Mac

• Sada Visual Studio pro Mac verze 8.4 nebo novější
• Sada .NET Core 3.1 SDK

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

Reakce na změny SameSite cookie

Implementace SameSite atributů pro soubory cookie HTTP se 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í:

• Práce s soubory cookie SameSite v ASP.NET Core
• aspnet/Oznámení#390
• Nadcházející změny SameSite cookie v ASP.NET a ASP.NET Core

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 Integrace komponent ASP.NET Core Razor s MVC nebo Razor Pages.

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.