Eseguire la migrazione da ASP.NET Core 3.0 a 3.1

  • Articolo

Di Scott Addie

Questo articolo illustra come aggiornare un progetto ASP.NET Core 3.0 esistente a ASP.NET Core 3.1.

Prerequisiti

Aggiornare la versione di .NET Core SDK in global.json

Se si fa affidamento su un global.json file per specificare una versione specifica di .NET Core SDK, aggiornare la version proprietà alla versione 3.1 dell'SDK installata. Ad esempio:

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

Aggiornare il framework di destinazione

Nel file di progetto aggiornare il moniker framework di destinazione (TFM) a netcoreapp3.1:

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

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

</Project>

Aggiornare i riferimenti del pacchetto

Nel file di progetto aggiornare l'attributo di ogni Microsoft.AspNetCore.* riferimento al Version pacchetto alla versione 3.1.0 o successiva. Ad esempio:

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

Aggiornare le immagini Docker

Per le app che usano Docker, usare un'immagine di base che include ASP.NET Core 3.1. Ad esempio:

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

Le SameSite implementazioni degli attributi per HTTP cookiesono cambiate tra ASP.NET Core 3.0 e 3.1. Per le azioni da eseguire, vedere le risorse seguenti:

Pubblicare con Visual Studio

.pubxml Nel file aggiornare a TargetFramework 3.1:

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

Rivedere le modifiche che causano un'interruzione

Esaminare le modifiche di rilievo da 3.0 a 3.1 in .NET Core, ASP.NET Core ed Entity Framework Core in Modifiche di rilievo per la migrazione dalla versione 3.0 alla 3.1.

Modifiche facoltative

Le modifiche seguenti sono facoltative.

Usare l'helper tag del componente

ASP.NET Core 3.1 introduce un Component helper tag. L'helper tag può sostituire il RenderComponentAsync<TComponent> metodo helper HTML in un Blazor progetto. Ad esempio:

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

Per altre informazioni, vedere Prerender and integrate ASP.NET Core components .For more information, see Prerender and integrate ASP.NET Core Razor components.

modulo ASP.NET core (ANCM)

Se la ASP.NET Core Module (ANCM) non è un componente selezionato quando Visual Studio è stato installato o se è stata installata una versione precedente di ANCM nel sistema, scaricare l'ultimo programma di installazione del bundle di hosting .NET Core (download diretto) ed eseguire il programma di installazione. Per altre informazioni, vedere Bundle di hosting.