Compartilhar via

Migrar do ASP.NET Core no .NET 8 para o ASP.NET Core no .NET 9

  • Artigo

Este artigo explica como atualizar um ASP.NET Core no .NET 8 para o ASP.NET Core no .NET 9.

Pré-requisitos

Atualizar a versão do SDK do .NET Core em global.json

Se você depende de um arquivo global.json para o direcionamento a uma versão específica do SDK do .NET Core, atualize a propriedade version para a versão do SDK do .NET 9.0 instalada. Por exemplo:

{
  "sdk": {
-    "version": "8.0.100"
+    "version": "9.0.100"
  }
}

Atualizar a estrutura de destino

Atualize o TFM (Moniker da Estrutura de Destino) do arquivo de projeto para net9.0:

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

  <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>

Referências do pacote de atualização

No arquivo do projeto, atualize o atributo Version de cada referência de pacote Microsoft.AspNetCore.*, Microsoft.EntityFrameworkCore.*, Microsoft.Extensions.* e System.Net.Http.Json para 9.0.0 ou posterior. Por exemplo:

<ItemGroup>
-   <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="8.0.2" />
-   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.2" />
-   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="8.0.0" />
-   <PackageReference Include="System.Net.Http.Json" Version="8.0.0" />
+   <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="9.0.0-preview.1.24081.5" />
+   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.0-preview.1.24081.2" />
+   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="9.0.0-preview.1.24080.9" />
+   <PackageReference Include="System.Net.Http.Json" Version="9.0.0-preview.1.24080.9" />
</ItemGroup>

Blazor

As diretrizes de migração do Blazor aparecerão aqui antes do lançamento do .NET 9, que está programado para novembro de 2024.

Recursos adicionais