Migrer de ASP.NET Core 3.0 vers la version 3.1

Par Scott Addie

Cet article explique comment mettre à jour un projet ASP.NET Core 3.0 existant vers ASP.NET Core 3.1.

Prérequis

Mettre à jour la version du SDK .NET Core dans global.json

Si vous vous appuyez sur un fichier global.json pour cibler une version spécifique du Kit de développement logiciel (SDK) .NET Core, mettez à jour la version propriété vers la version du SDK 3.1 installée. Par exemple :

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

Mettre à jour le framework cible

Dans le fichier projet, mettez à jour le moniker du framework cible (TFM) sur netcoreapp3.1:

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

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

</Project>

Mettre à jour les références de package

Dans le fichier projet, mettez à jour l’attribut de chaque Microsoft.AspNetCore.* référence de Version package vers la version 3.1.0 ou ultérieure. Par exemple :

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

Mettre à jour des images Docker

Pour les applications utilisant Docker, utilisez une image de base qui inclut ASP.NET Core 3.1. Par exemple :

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

Les SameSite implémentations d’attribut pour HTTP cookieont changé entre ASP.NET Core 3.0 et 3.1. Pour connaître les actions à entreprendre, consultez les ressources suivantes :

Publier avec Visual Studio

Dans le .pubxml fichier, mettez à jour la TargetFramework version 3.1 :

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

Passer en revue les changements cassants

Passez en revue les changements cassants 3.0 à 3.1 dans .NET Core, ASP.NET Core et Entity Framework Core lors des changements cassants pour la migration de la version 3.0 vers la version 3.1.

Modifications facultatives

Les modifications suivantes sont facultatives.

Utiliser le Tag Helper de composant

ASP.NET Core 3.1 introduit une Component Tag Helper. Tag Helper peut remplacer la méthode d’assistance RenderComponentAsync<TComponent> HTML dans un Blazor projet. Par exemple :

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

Pour plus d’informations, consultez Prerender et intégrez ASP.NET Core Razor composants.

module ASP.NET Core (ANCM)

Si le module ASP.NET Core (ANCM) n’était pas un composant sélectionné lors de l’installation de Visual Studio ou si une version antérieure de l’ANCM a été installée sur le système, téléchargez le dernier programme d’installation du bundle d’hébergement .NET Core (téléchargement direct) et exécutez le programme d’installation. Pour plus d’informations, consultez Bundle d’hébergement.