Compartir a través de

Migración de ASP.NET Core en .NET 8 a ASP.NET Core en .NET 9

En este artículo se explica cómo actualizar un ASP.NET Core en .NET 8 a ASP.NET Core en .NET 9.

Requisitos previos

Actualización de la versión del SDK de .NET en global.json

Si confía en un global.json archivo para tener como destino una versión específica del SDK de .NET Core, actualice la version propiedad a la versión del SDK de .NET 9 instalada. Por ejemplo:

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

Actualización de la plataforma de destino

Actualice el moniker de la plataforma de destino (TFM) del archivo de proyecto a net9.0:

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

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

</Project>

Actualización de las referencias del paquete

En el archivo del proyecto, actualice el atributo Microsoft.AspNetCore.* de cada paquete de referencia Microsoft.EntityFrameworkCore.*, Microsoft.Extensions.*, System.Net.Http.Json y Version a 9.0.0 o posterior. Por ejemplo:

<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" />
+   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.0" />
+   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="9.0.0" />
+   <PackageReference Include="System.Net.Http.Json" Version="9.0.0" />
</ItemGroup>

Reemplazar UseStaticFiles con MapStaticAssets

Optimice el control de archivos estáticos en las aplicaciones web reemplazando UseStaticFiles por MapStaticAssets en el archivo de la Program aplicación:

- app.UseStaticFiles();
+ app.MapStaticAssets();

En las aplicaciones de MVC y Razor Pages, también necesita encadenar una llamada a .WithStaticAssets después MapRazorPages o MapControllerRoute en Program.cs. Para obtener un ejemplo, consulte los archivos estáticos en ASP.NET Core.

ASP.NET Core captura automáticamente huellas digitales y precomprime los archivos estáticos en tiempo de compilación y publicación y, a continuación MapStaticAssets , expone los archivos optimizados como puntos de conexión mediante el enrutamiento de puntos de conexión con los encabezados de almacenamiento en caché adecuados.

Para resolver los nombres de archivo con huellas digitales de la aplicación:

  • En Blazor las aplicaciones, use la ComponentBase.Assets propiedad . Actualice las referencias explícitas a recursos estáticos en Razor archivos de componentes (.razor) para usar @Assets["{ASSET PATH}"], donde el {ASSET PATH} marcador de posición es la ruta de acceso al recurso. Tenga en cuenta que esto NO debe hacerse para los scripts del Blazor marco (blazor.*.js). En el siguiente ejemplo, Bootstrap, la hoja de estilos de la aplicación de plantilla de proyecto () y la hoja de estilos de aislamiento CSS () basada en el espacio de nombres de una aplicación como están vinculadas en un componente raíz, que suele ser el componente ().

    <link rel="stylesheet" href="@Assets["bootstrap/bootstrap.min.css"]" />
<link rel="stylesheet" href="@Assets["app.css"]" />
<link rel="stylesheet" href="@Assets["BlazorSample.styles.css"]" />

  • En las aplicaciones de MVC y Razor Pages, los asistentes de etiquetas de script y vínculo resolverán automáticamente los nombres de archivo con huellas digitales.

Para resolver los nombres de archivo con huellas digitales al importar módulos de JavaScript, agregue un mapa de importación generado:

  • En Blazor las aplicaciones, agregue el componente (ImportMap) al <head> contenido del componente raíz de la aplicación, normalmente en el App componente (App.razor):

    <ImportMap />

  • En las aplicaciones de MVC y Razor pages, agregue <script type="importmap"></script> al encabezado del archivo de diseño principal, que se actualiza mediante el Asistente de etiquetas de mapa de importación.

Para obtener más información, consulte los siguientes recursos:

Blazor

Adopción de la serialización simplificada del estado de autenticación para Blazor Web Apps

Blazor Web Appopcionalmente, puede adoptar la serialización simplificada del estado de autenticación.

En el proyecto de servidor:

  • Quite el proveedor de estado de autenticación persistente (PersistingAuthenticationStateProvider.cs).

  • Quite el registro del servicio del Program archivo. En su lugar, encadene una llamada a AddAuthenticationStateSerialization en AddRazorComponents:

    - builder.Services.AddScoped<AuthenticationStateProvider, PersistingAuthenticationStateProvider>();

  builder.Services.AddRazorComponents()
      .AddInteractiveServerComponents()
      .AddInteractiveWebAssemblyComponents()
+     .AddAuthenticationStateSerialization();

La API solo serializa las notificaciones de rol y nombre del lado servidor para el acceso en el explorador. Para incluir todas las notificaciones, establezca en SerializeAllClaimstrue:

.AddAuthenticationStateSerialization(options => options.SerializeAllClaims = true);

En el proyecto de cliente (.Client):

  • Quite el proveedor de estado de autenticación persistente (PersistentAuthenticationStateProvider.cs).

  • Quite el registro del servicio del Program archivo. En su lugar, llame a AddAuthenticationStateDeserialization en la colección de servicios:

    - builder.Services.AddSingleton<AuthenticationStateProvider, PersistentAuthenticationStateProvider>();
+ builder.Services.AddAuthenticationStateDeserialization();

Para obtener más información, consulte Novedades de ASP.NET Core en .NET 9.

El atributo de representación de streaming ya no requiere el parámetro true

En .NET 8, la representación de streaming requiere que usted pase true para el parámetro enabled:

@attribute [StreamRendering(true)]

En .NET 9 o posterior, se puede quitar opcionalmente true, ya que ahora true es el valor predeterminado para el parámetro enabled:

@attribute [StreamRendering]

Recursos adicionales