Condividi tramite


Modifiche di rilievo in ASP.NET Core 10

Se si esegue la migrazione di un'app a ASP.NET Core 10, le modifiche di rilievo elencate di seguito potrebbero influire sull'utente.

Questo articolo classifica ogni modifica che causa un'interruzione come binaria non compatibile o origine non compatibile o come modifica funzionale:

  • Binari non compatibili: quando vengono eseguiti sul nuovo runtime o componente, i file binari esistenti possono riscontrare una modifica che comporta un cambiamento radicale nel comportamento, come un errore di caricamento o esecuzione, e, in tal caso, richiedono la ricompilazione.

  • Origine non compatibile : quando viene ricompilata usando il nuovo SDK o componente oppure per specificare come destinazione il nuovo runtime, il codice sorgente esistente potrebbe richiedere modifiche all'origine per la compilazione.

  • Modifica comportamentale : il codice esistente e i file binari possono comportarsi in modo diverso in fase di esecuzione. Se il nuovo comportamento non è desiderato, è necessario aggiornare e ricompilare il codice esistente.

Titolo Tipo di modifica
Reindirizzamenti di accesso ai cookie disabilitati per gli endpoint API noti Cambiamento comportamentale
Deprecazione del metodo di estensione WithOpenApi Origine non compatibile
Diagnostica delle eccezioni eliminata quando TryHandleAsync restituisce true Cambiamento comportamentale
IActionContextAccessor e ActionContextAccessor sono obsoleti Modifica incompatibile/comportamentale della sorgente
La proprietà IncludeOpenAPIAnalyzers e gli analizzatori API MVC sono deprecati Origine non compatibile
IPNetwork e ForwardedHeadersOptions.KnownNetworks sono obsoleti Origine non compatibile
Pacchetto Microsoft.Extensions.ApiDescription.Client deprecato Origine non compatibile
Razor la compilazione di runtime è obsoleta Origine non compatibile
WebHostBuilder, IWebHost e WebHost sono obsoleti Origine non compatibile