Condividi tramite


Eseguire la migrazione da ASP.NET Core 3.1 a 5.0

Questo articolo illustra come aggiornare un progetto ASP.NET Core 3.1 esistente a ASP.NET Core 5.0. Per istruzioni su come eseguire la migrazione da ASP.NET Core 3.1 a ASP.NET Core 6.0, vedere Eseguire la migrazione da ASP.NET Core 3.1 a 6.0.

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 di .NET 5.0 SDK installata. Ad esempio:

{
  "sdk": {
-    "version": "3.1.200"
+    "version": "5.0.100"
  }
}

Aggiornare il framework di destinazione

Se si aggiorna un Blazor WebAssembly progetto, passare alla sezione Aggiorna Blazor WebAssembly progetti . Per qualsiasi altro tipo di progetto ASP.NET Core, aggiornare il moniker framework di destinazione (TFM) del file di progetto in net5.0:

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

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

</Project>

Eliminare bin e obj cartelle

Potrebbe essere necessario eliminare le bin cartelle e obj . Eseguire dotnet nuget locals --clear all per cancellare la cache dei pacchetti NuGet.

Modifiche alla Blazor logica di routing delle app nella versione 5.0.1 e altre versioni 5.x fino a 6.0

Il calcolo della precedenza della route è cambiato nella versione patch di ASP.NET Core 5.0.1. Ciò potrebbe influire sull'utente se sono state definite route o route catch-all con parametri facoltativi.

Comportamento precedente

Con il comportamento precedente in ASP.NET Core 5.0.0 o versioni precedenti, le route con precedenza inferiore, ad esempio {*slug}, vengono confrontate prima delle route con precedenza superiore, ad esempio /customer/{id}.

Nuovo comportamento

Il nuovo comportamento in ASP.NET Core 5.0.1 o versione successiva corrisponde più strettamente al comportamento di routing definito nelle app ASP.NET Core, in cui il framework calcola e stabilisce la precedenza di route per ogni segmento per primo e usa solo la lunghezza della route per interrompere i legami come criteri secondari.

Motivo della modifica

Il comportamento originale è considerato un bug nell'implementazione perché l'obiettivo è che il Blazor sistema di routing si comporti allo stesso modo del sistema di routing ASP.NET Core per il subset di funzionalità supportate dal Blazor routing.

Aggiungere l'attributo PreferExactMatches al Router componente nel App.razor file per acconsentire esplicitamente al comportamento corretto:

<Router AppAssembly="@typeof(Program).Assembly" PreferExactMatches="@true">

Quando PreferExactMatches è impostato su @true, l'abbinamento delle route preferisce corrispondenze esatte rispetto ai caratteri jolly.

Importante

Tutte le app devono essere impostate in modo esplicito su PreferExactMatches @true.

La possibilità di impostare PreferExactMatches @false o lasciare non impostato è disponibile solo per la compatibilità con le versioni precedenti.

Quando viene rilasciato .NET 6, il router preferisce sempre corrispondenze esatte e l'opzione PreferExactMatches non sarà disponibile.

Aggiornare Blazor WebAssembly e Blazor Server progetti

Le indicazioni contenute in questa sezione si applicano a entrambi Blazor i modelli di hosting. Le sezioni seguenti in questa sezione forniscono indicazioni aggiuntive specifiche per l'hosting di modelli e tipi di app. Applicare le indicazioni di tutte le sezioni pertinenti all'app.

  1. In wwwroot/index.html di un'app Blazor WebAssembly o Pages/_Host.cshtml di un'app Blazor Server aggiungere un <link> elemento all'elemento per gli <head> stili. Nei valori di attributo dell'elemento href seguenti<link>, il segnaposto {ASSEMBLY NAME} è il nome dell'assembly dell'app.

    +<link href="{ASSEMBLY NAME}.styles.css" rel="stylesheet" />
    

    Autonomo Blazor WebAssembly o Blazor Server esempio:

    +<link href="BlazorSample.styles.css" rel="stylesheet" />
    

    Client progetto di un esempio di soluzione ospitata Blazor WebAssembly :

    +<link href="BlazorSample.Client.styles.css" rel="stylesheet" />
    
  2. Includere un nuovo spazio dei nomi nel file dell'app per la virtualizzazione dei _Imports.razor componenti, Microsoft.AspNetCore.Components.Web.Virtualization. I file seguenti _Imports.razor mostrano gli spazi dei nomi predefiniti nelle app generate dai modelli di Blazor progetto. Il segnaposto {ASSEMBLY NAME} è il nome dell'assembly dell'app.

    Blazor WebAssembly (_Imports.razor):

    @using System.Net.Http
    @using System.Net.Http.Json
    @using Microsoft.AspNetCore.Components.Forms
    @using Microsoft.AspNetCore.Components.Routing
    @using Microsoft.AspNetCore.Components.Web
    @using Microsoft.AspNetCore.Components.Web.Virtualization
    @using Microsoft.AspNetCore.Components.WebAssembly.Http
    @using Microsoft.JSInterop
    @using {ASSEMBLY NAME}
    @using {ASSEMBLY NAME}.Shared
    

    Blazor Server (_Imports.razor):

    @using System.Net.Http
    @using Microsoft.AspNetCore.Authorization
    @using Microsoft.AspNetCore.Components.Authorization
    @using Microsoft.AspNetCore.Components.Forms
    @using Microsoft.AspNetCore.Components.Routing
    @using Microsoft.AspNetCore.Components.Web
    @using Microsoft.AspNetCore.Components.Web.Virtualization
    @using Microsoft.JSInterop
    @using {ASSEMBLY NAME}
    @using {ASSEMBLY NAME}.Shared
    
  3. MainLayout Nel componente (Shared/MainLayout.razor) racchiudere il markup HTML del componente con un elemento con un <div> class attributo impostato su page:

    <div class="page">
    
        ...
    
    </div>
    
  4. Aggiungere i file seguenti alla Shared cartella :

    MainLayout.razor.css:

    .page {
        position: relative;
        display: flex;
        flex-direction: column;
    }
    
    .main {
        flex: 1;
    }
    
    .sidebar {
        background-image: linear-gradient(180deg, rgb(5, 39, 103) 0%, #3a0647 70%);
    }
    
    .top-row {
        background-color: #f7f7f7;
        border-bottom: 1px solid #d6d5d5;
        justify-content: flex-end;
        height: 3.5rem;
        display: flex;
        align-items: center;
    }
    
        .top-row ::deep a, .top-row .btn-link {
            white-space: nowrap;
            margin-left: 1.5rem;
        }
    
        .top-row a:first-child {
            overflow: hidden;
            text-overflow: ellipsis;
        }
    
    @media (max-width: 767.98px) {
        .top-row:not(.auth) {
            display: none;
        }
    
        .top-row.auth {
            justify-content: space-between;
        }
    
        .top-row a, .top-row .btn-link {
            margin-left: 0;
        }
    }
    
    @media (min-width: 768px) {
        .page {
            flex-direction: row;
        }
    
        .sidebar {
            width: 250px;
            height: 100vh;
            position: sticky;
            top: 0;
        }
    
        .top-row {
            position: sticky;
            top: 0;
            z-index: 1;
        }
    
        .main > div {
            padding-left: 2rem !important;
            padding-right: 1.5rem !important;
        }
    }
    

    NavMenu.razor.css:

    .navbar-toggler {
        background-color: rgba(255, 255, 255, 0.1);
    }
    
    .top-row {
        height: 3.5rem;
        background-color: rgba(0,0,0,0.4);
    }
    
    .navbar-brand {
        font-size: 1.1rem;
    }
    
    .oi {
        width: 2rem;
        font-size: 1.1rem;
        vertical-align: text-top;
        top: -2px;
    }
    
    .nav-item {
        font-size: 0.9rem;
        padding-bottom: 0.5rem;
    }
    
        .nav-item:first-of-type {
            padding-top: 1rem;
        }
    
        .nav-item:last-of-type {
            padding-bottom: 1rem;
        }
    
        .nav-item ::deep a {
            color: #d7d7d7;
            border-radius: 4px;
            height: 3rem;
            display: flex;
            align-items: center;
            line-height: 3rem;
        }
    
    .nav-item ::deep a.active {
        background-color: rgba(255,255,255,0.25);
        color: white;
    }
    
    .nav-item ::deep a:hover {
        background-color: rgba(255,255,255,0.1);
        color: white;
    }
    
    @media (min-width: 768px) {
        .navbar-toggler {
            display: none;
        }
    
        .collapse {
            /* Never collapse the sidebar for wide screens */
            display: block;
        }
    }
    
  5. Il file di base wwwroot/css/app.css più recente di un'app o wwwroot/css/site.css di un Blazor WebAssembly file di un'app Blazor Server include gli stili seguenti. Rimuovere gli stili aggiuntivi lasciando gli stili seguenti e gli eventuali elementi aggiunti all'app.

    Il foglio di stile seguente include solo gli stili di base e non include gli stili personalizzati aggiunti dallo sviluppatore:

    html, body {
        font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
    }
    
    a, .btn-link {
        color: #0366d6;
    }
    
    .btn-primary {
        color: #fff;
        background-color: #1b6ec2;
        border-color: #1861ac;
    }
    
    .content {
        padding-top: 1.1rem;
    }
    
    .valid.modified:not([type=checkbox]) {
        outline: 1px solid #26b050;
    }
    
    .invalid {
        outline: 1px solid red;
    }
    
    .validation-message {
        color: red;
    }
    
    #blazor-error-ui {
        background: lightyellow;
        bottom: 0;
        box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
        display: none;
        left: 0;
        padding: 0.6rem 1.25rem 0.7rem 1.25rem;
        position: fixed;
        width: 100%;
        z-index: 1000;
    }
    
    #blazor-error-ui .dismiss {
        cursor: pointer;
        position: absolute;
        right: 0.75rem;
        top: 0.5rem;
    }
    

    Nota

    L'esempio precedente non mostra la @import direttiva per le icone Open Iconic (open-iconic-bootstrap.css), fornita dal modello di Blazor progetto. Open Iconic è stato abbandonato dai suoi gestori.

Aggiornare progetti Blazor WebAssembly

Seguire le indicazioni riportate nella sezione Precedente Aggiornamento Blazor WebAssembly e Blazor Server progetti .

Per un Blazor WebAssembly progetto, incluso il Client progetto di una soluzione ospitata Blazor , applicare le modifiche seguenti al file di progetto:

  1. Aggiornare l'SDK da Microsoft.NET.Sdk.Web a Microsoft.NET.Sdk.BlazorWebAssembly:

    - <Project Sdk="Microsoft.NET.Sdk.Web">
    + <Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
    

    Nota

    Questo aggiornamento si applica solo ai progetti autonomi Blazor WebAssembly e ai Client progetti di soluzioni ospitate Blazor .

  2. Aggiornare le proprietà seguenti:

    <Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
    
      <PropertyGroup>
    -     <TargetFramework>netstandard2.1</TargetFramework>
    -     <RazorLangVersion>3.0</RazorLangVersion>
    +     <TargetFramework>net5.0</TargetFramework>
      </PropertyGroup>
    
  3. Rimuovere il riferimento al pacchetto a Microsoft.AspNetCore.Components.WebAssembly.Build:

    <ItemGroup>
    -    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.Build" Version="3.2.1" PrivateAssets="all" />
    
  4. Aggiornare altri pacchetti alle versioni più recenti. Le versioni più recenti sono disponibili in NuGet.org.

  5. In wwwroot/index.htmlmodificare l'elemento che carica il App componente in un <div> elemento con un id oggetto impostato su app:

    -<app>Loading...</app>
    +<div id="app">Loading...</div>
    
  6. In Program.Main (Program.cs), modificare il riferimento all'elemento <app> in un selettore CSS aggiungendo un hash # al selettore:

    -builder.RootComponents.Add<App>("app");
    +builder.RootComponents.Add<App>("#app");
    
  7. In Program.Main (Program.cs), modificare una registrazione temporanea HttpClient predefinita impostando come ambito, se presente:

    -builder.Services.AddTransient(sp => new HttpClient 
    -    { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });
    +builder.Services.AddScoped(sp => new HttpClient 
    +    { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });
    
  8. In Program.Main (Program.cs) dell'app Client delle soluzioni ospitate Blazor :

    • Facoltativamente, sostituire builder.HostEnvironment.BaseAddress con gli indirizzi di base client stringa.
    • Modificare tutte le registrazioni di factory client temporanee denominate in ambito.
    -builder.Services.AddHttpClient("{APP NAMESPACE}.ServerAPI", 
    -    client => client.BaseAddress = new Uri("https://localhost:5001"))
    -    .AddHttpMessageHandler<BaseAddressAuthorizationMessageHandler>();
    -builder.Services.AddTransient(sp => sp.GetRequiredService<IHttpClientFactory>()
    -    .CreateClient("{APP NAMESPACE}.ServerAPI"));
    +builder.Services.AddHttpClient("{APP NAMESPACE}.ServerAPI", 
    +    client => client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress))
    +    .AddHttpMessageHandler<BaseAddressAuthorizationMessageHandler>();
    +builder.Services.AddScoped(sp => sp.GetRequiredService<IHttpClientFactory>()
    +    .CreateClient("{APP NAMESPACE}.ServerAPI"));
    

    Nel codice precedente il {APP NAMESPACE} segnaposto è lo spazio dei nomi dell'app.

App autonoma Blazor WebAssembly con account Microsoft

Seguire le indicazioni riportate nelle sezioni Precedenti Aggiornamenti Blazor WebAssembly e Blazor Server progetti e Aggiorna Blazor WebAssembly progetti .

Per un'app autonoma Blazor WebAssembly registrata nel portale di Azure usare Microsoft Entra ID (ME-ID) per gli account Microsoft:

  • L'app richiede gli openid ambiti e offline_access :

    options.ProviderOptions.DefaultAccessTokenScopes.Add("openid");
    options.ProviderOptions.DefaultAccessTokenScopes.Add("offline_access");
    
  • Nel pannello autenticazione di registrazione dell'app portale di Azure:

    1. Rimuovere la configurazione della piattaforma Web .
    2. Aggiungere una configurazione della piattaforma dell'applicazione a pagina singola con l'URI di reindirizzamento dell'app.
    3. Disabilitare la concessione implicita per token di accesso e token ID.

Per altre informazioni, vedere Proteggere un'app autonoma di ASP.NET Core Blazor WebAssembly con gli account Microsoft.

App autonoma Blazor WebAssembly con Microsoft Entra ID (ME-ID)

Seguire le indicazioni riportate nelle sezioni Precedenti Aggiornamenti Blazor WebAssembly e Blazor Server progetti e Aggiorna Blazor WebAssembly progetti .

Per un'app autonoma Blazor WebAssembly registrata nel portale di Azure usare Microsoft Entra ID (ME-ID):

  • L'app richiede l'ambito https://graph.microsoft.com/User.Read :

    options.ProviderOptions.DefaultAccessTokenScopes
        .Add("https://graph.microsoft.com/User.Read");
    
  • Nel pannello autenticazione di registrazione dell'app portale di Azure:

    1. Rimuovere la configurazione della piattaforma Web .
    2. Aggiungere una configurazione della piattaforma dell'applicazione a pagina singola con l'URI di reindirizzamento dell'app.
    3. Disabilitare la concessione implicita per token di accesso e token ID.

Per altre informazioni, vedere Proteggere un'app autonoma di ASP.NET Core Blazor WebAssembly con Microsoft Entra ID.

App autonoma Blazor WebAssembly con Azure Active Directory (AAD) B2C

Seguire le indicazioni riportate nelle sezioni Precedenti Aggiornamenti Blazor WebAssembly e Blazor Server progetti e Aggiorna Blazor WebAssembly progetti .

Per un'app autonoma Blazor WebAssembly registrata nel portale di Azure usare Azure Active Directory (AAD) B2C:

  • L'app richiede gli openid ambiti e offline_access :

    options.ProviderOptions.DefaultAccessTokenScopes.Add("openid");
    options.ProviderOptions.DefaultAccessTokenScopes.Add("offline_access");
    
  • Nel pannello autenticazione di registrazione dell'app portale di Azure:

    1. Rimuovere la configurazione della piattaforma Web .
    2. Aggiungere una configurazione della piattaforma dell'applicazione a pagina singola con l'URI di reindirizzamento dell'app.
    3. Disabilitare la concessione implicita per token di accesso e token ID.

Per altre informazioni, vedere Proteggere un'app autonoma ASP.NET Core Blazor WebAssembly con Azure Active Directory B2C.

App ospitata Blazor WebAssembly con Microsoft Entra ID (ME-ID) o AAD B2C

Seguire le indicazioni riportate nelle sezioni Precedenti Aggiornamenti Blazor WebAssembly e Blazor Server progetti e Aggiorna Blazor WebAssembly progetti .

La Client registrazione dell'app di una soluzione ospitata Blazor che usa AAD o AAD B2C per l'autenticazione utente deve usare una configurazione della piattaforma a pagina singola app Azure s.

Nel pannello autenticazione di registrazione dell'app portale di AzureClient:

  1. Rimuovere la configurazione della piattaforma Web .
  2. Aggiungere una configurazione della piattaforma dell'applicazione a pagina singola con l'URI di reindirizzamento dell'app.
  3. Disabilitare la concessione implicita per token di accesso e token ID.

Per altre informazioni, vedi:

Aggiornare il progetto Server di una soluzione ospitata Blazor

Seguire le indicazioni riportate nelle sezioni precedenti:

Aggiornare il Server progetto di una soluzione ospitata Blazor come app ASP.NET Core seguendo le indicazioni generali in questo articolo.

Inoltre, Server i progetti che autenticano gli utenti alle app client Blazor WebAssembly con Microsoft Entra ID (ME-ID) o B2C devono adottare nuovi pacchetti Microsoft Identity v2.0:

Per AAD:

-<PackageReference Include="Microsoft.AspNetCore.Authentication.AzureAD.UI" Version="..." />
+<PackageReference Include="Microsoft.Identity.Web" Version="{VERSION}" />
+<PackageReference Include="Microsoft.Identity.Web.UI" Version="{VERSION}" />

Per AAD B2C:

-<PackageReference Include="Microsoft.AspNetCore.Authentication.AzureADB2C.UI" Version="..." />
+<PackageReference Include="Microsoft.Identity.Web" Version="{VERSION}" />
+<PackageReference Include="Microsoft.Identity.Web.UI" Version="{VERSION}" />

Per i riferimenti al pacchetto precedente, determinare le versioni del pacchetto per i {VERSION} segnaposto in NuGet.org:

Nota

L'SDK del Server progetto in una soluzione ospitata Blazor WebAssembly rimane Microsoft.NET.Sdk.Web:

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

Per altre informazioni, vedi:

Pulire e ricompilare la soluzione

Dopo la migrazione dell'app o della soluzione a .NET 5, pulire e ricompilare l'app o la soluzione. Se esistono incompatibilità dei pacchetti tra i nuovi riferimenti al pacchetto e i pacchetti memorizzati nella cache:

  1. Cancellare le cache dei pacchetti NuGet eseguendo il comando seguente dotnet nuget locals in una shell dei comandi:

    dotnet nuget locals --clear all
    
  2. Pulire e ricompilare l'app o la soluzione.

Risoluzione dei problemi

Seguire le indicazioni sulla risoluzione dei problemi alla fine dell'argomento Blazor WebAssembly sulla sicurezza applicabile all'app:

App Blazor WebAssembly autonome:

App Blazor WebAssembly ospitate:

Client non autorizzato per Microsoft Entra ID (ME-ID)

Dopo l'aggiornamento di un'app Blazor WebAssembly che usa AAD per l'autenticazione, è possibile che venga visualizzato l'errore seguente nel callback di accesso all'app dopo l'accesso dell'utente con AAD:

info: Microsoft.AspNetCore.Authorization.DefaultAuthorizationService[2] Autorizzazione non riuscita. Questi requisiti non sono stati soddisfatti: DenyAnonymousAuthorizationRequirement: richiede un utente autenticato.

Errore di callback di accesso da AAD:

  • Errore: unauthorized_client
  • Description (Descrizione): AADB2C90058: The provided application is not configured to allow public clients.

Per risolvere l'errore:

  1. Nella portale di Azure accedere al manifesto dell'app.
  2. Impostare l'attributo allowPublicClient su null o true.

Aggiornare un'applicazione Blazor Web progressiva (PWA)

Aggiungere l'elemento seguente al file di progetto dell'app PWA:

<ItemGroup>
  <ServiceWorker Include="wwwroot\service-worker.js" 
    PublishedContent="wwwroot\service-worker.published.js" />
</ItemGroup>

Se il progetto wwwroot/index.html (Blazor WebAssembly) o Pages/_Host.cshtml (Blazor Server) contiene un elemento del foglio <link> di stile per scoped.styles.css da una versione di anteprima 5.0 precedente, rimuovere il <link> tag:

-<link href="_framework/scoped.styles.css/" rel="stylesheet" />

Aggiornare Razor le librerie di classi (RCL)

Eseguire la migrazione Razor delle librerie di classi (RCLs) per sfruttare le nuove API o le nuove funzionalità introdotte come parte di ASP.NET Core 5.0.

Per aggiornare un RCL destinato ai componenti:

  1. Aggiornare le proprietà seguenti nel file di progetto:

    <Project Sdk="Microsoft.NET.Sdk.Razor">
    
      <PropertyGroup>
    -     <TargetFramework>netstandard2.0</TargetFramework>
    -     <RazorLangVersion>3.0</RazorLangVersion>
    +     <TargetFramework>net5.0</TargetFramework>
      </PropertyGroup>
    
  2. Aggiornare altri pacchetti alle versioni più recenti. Le versioni più recenti sono disponibili in NuGet.org.

Per aggiornare un RCL destinato a MVC, aggiornare le proprietà seguenti nel file di progetto:

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

  <PropertyGroup>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
    <AddRazorSupportForMvc>true</AddRazorSupportForMvc>
  </PropertyGroup>

Aggiornare i riferimenti del pacchetto

Nel file di progetto aggiornare ogni attributo del pacchetto Microsoft.AspNetCore.*, Microsoft.EntityFrameworkCore.*, Microsoft.Extensions.*e l'attributo del Version riferimento al pacchetto System.Net.Http.Json alla versione 5.0.0 o successiva. Ad esempio:

<ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="3.1.6" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.1.6">
-    <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="3.1.6" />
-    <PackageReference Include="System.Net.Http.Json" Version="3.2.1" />
+    <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="5.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="5.0.0">
+    <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="5.0.0" />
+    <PackageReference Include="System.Net.Http.Json" Version="5.0.0" />
</ItemGroup>

Aggiornare le immagini Docker

Per le app che usano Docker, aggiornare le istruzioni e gli script DockerfileFROM. Usare un'immagine di base che include il runtime di ASP.NET Core 5.0. Considerare la differenza di comando seguente docker pull tra ASP.NET Core 3.1 e 5.0:

- docker pull mcr.microsoft.com/dotnet/core/aspnet:3.1
+ docker pull mcr.microsoft.com/dotnet/aspnet:5.0

Come parte del passaggio a ".NET" come nome del prodotto, le immagini Docker spostate dai mcr.microsoft.com/dotnet/core repository a mcr.microsoft.com/dotnet. Per altre informazioni, vedere dotnet/dotnet-docker#1939.

Modifiche all'associazione di modelli in ASP.NET Core MVC e Razor pages

I valori DateTime sono associati al modello come ore UTC

In ASP.NET Core 3.1 e versioni precedenti, DateTime i valori sono associati al modello come ora locale, in cui il fuso orario è stato determinato dal server. DateTime i valori associati dalla formattazione di input (JSON) e DateTimeOffset i valori sono stati associati come fusi orari UTC.

In ASP.NET Core 5.0 e versioni successive, l'associazione di modelli associa in modo coerente i DateTime valori al fuso orario UTC.

Per mantenere il comportamento precedente, rimuovere in DateTimeModelBinderProvider Startup.ConfigureServices:

services.AddControllersWithViews(options => 
    options.ModelBinderProviders.RemoveType<DateTimeModelBinderProvider>());

ComplexObjectModelBinderProvider \ ComplexObjectModelBinder replace ComplexTypeModelBinderProvider \ ComplexTypeModelBinder

Per aggiungere il supporto per i tipi di record C# 9 di associazione di modelli, ComplexTypeModelBinderProvider è:

  • Annotato come obsoleto.
  • Non più registrato per impostazione predefinita.

Le app che si basano sulla presenza di ComplexTypeModelBinderProvider nella ModelBinderProviders raccolta devono fare riferimento al nuovo provider del gestore di associazione:

- var complexModelBinderProvider = options.ModelBinderProviders.OfType<ComplexTypeModelBinderProvider>();
+ var complexModelBinderProvider = options.ModelBinderProviders.OfType<ComplexObjectModelBinderProvider>();

UseDatabaseErrorPage obsoleto

I modelli ASP.NET Core 3.1 che includono un'opzione per i singoli account utente generano una chiamata a UseDatabaseErrorPage. UseDatabaseErrorPage è ora obsoleto e deve essere sostituito con una combinazione di AddDatabaseDeveloperPageExceptionFilter e UseMigrationsEndPoint, come illustrato nel codice seguente:

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<ApplicationDbContext>(options =>
        options.UseSqlServer(
            Configuration.GetConnectionString("DefaultConnection")));
+   services.AddDatabaseDeveloperPageExceptionFilter();
    services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
        .AddEntityFrameworkStores<ApplicationDbContext>();
    services.AddRazorPages();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
+       app.UseMigrationsEndPoint();
-       app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

Per altre informazioni, vedere questo problema in GitHub.

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.

Modifiche di riferimento ai pacchetti che interessano alcuni pacchetti NuGet

Con la migrazione di alcuni Microsoft.Extensions.* pacchetti NuGet dal repository dotnet/extensions a dotnet/runtime, come descritto in Migrazione del contenuto dotnet/extensions a dotnet/runtime e dotnet/aspnetcore (aspnet/Announcements #411), le modifiche alla creazione di pacchetti vengono applicate ad alcuni dei pacchetti migrati. Queste modifiche comportano spesso modifiche dello spazio dei nomi per l'API .NET.

Per cercare ulteriormente le API per le modifiche dello spazio dei nomi delle app durante la migrazione alla versione 5.0, usare il browser API .NET.

Eseguire la migrazione di Microsoft.Identity. Ragnatela

Le pagine wiki seguenti illustrano come eseguire la migrazione di Microsoft.Identity. Web da ASP.NET Core 3.1 a 5.0:

Le esercitazioni seguenti illustrano anche la migrazione:

Rivedere le modifiche che causano un'interruzione

Per modifiche di rilievo da .NET Core 3.1 a .NET 5.0, vedere Modifiche di rilievo per la migrazione dalla versione 3.1 alla versione 5.0. ASP.NET Core ed Entity Framework Core sono inclusi anche nell'elenco.