Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Se si esegue la migrazione di un'app a .NET 10, le modifiche di rilievo elencate qui potrebbero influire sull'utente. Le modifiche vengono raggruppate in base all'area tecnologica, ad esempio ASP.NET Core o Windows Forms.
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.
Annotazioni
Questo articolo è un lavoro in corso. Non è un elenco completo dei cambiamenti critici in .NET 10.
ASP.NET Core
| 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 |
Containers
| Titolo | Tipo di modifica |
|---|---|
| immagini .NET predefinite usano Ubuntu | Cambiamento comportamentale |
Principali librerie .NET
Crittografia
| Titolo | Tipo di modifica |
|---|---|
| CompositeMLDsa aggiornato alla bozza 08 | Cambiamento comportamentale |
| CoseSigner.Key può essere null | Modifica non compatibile del comportamento/della sorgente |
| Membri MLDsa e SlhDsa 'SecretKey' rinominati | Origine non compatibile |
| Le primitive di crittografia OpenSSL non sono supportate in macOS | Cambiamento comportamentale |
| OpenSSL 1.1.1 o versione successiva obbligatoria in Unix | Cambiamento comportamentale |
| La validazione di X500DistinguishedName è stata resa più restrittiva | Cambiamento comportamentale |
| I parametri chiave X509Certificate e PublicKey possono essere null | Modifica non compatibile del comportamento/della sorgente |
| Variabile di ambiente rinominata in DOTNET_OPENSSL_VERSION_OVERRIDE | Cambiamento comportamentale |
Entity Framework Core (un framework ORM per la gestione dei database nello sviluppo software)
Modifiche di rilievo in EF Core 10
Extensions
| Titolo | Tipo di modifica |
|---|---|
| BackgroundService esegue tutte le operazioni ExecuteAsync come attività | Cambiamento comportamentale |
| Risolvere i problemi in GetKeyedService() e GetKeyedServices() con AnyKey | Cambiamento comportamentale |
| Valori Null mantenuti nella configurazione | Cambiamento comportamentale |
| Messaggio non più duplicato nell'output del log della console | Cambiamento comportamentale |
| ProviderAliasAttribute è stato spostato nell'assembly Microsoft.Extensions.Logging.Abstractions | Origine non compatibile |
| Rimossa l'annotazione DynamicallyAccessedMembers dal codice Trim-unsafe Microsoft.Extensions.Configuration | Incompatibilità binaria |
Globalization
| Titolo | Tipo di modifica |
|---|---|
| Variabile di ambiente rinominata in DOTNET_ICU_VERSION_OVERRIDE | Cambiamento comportamentale |
Strumento di installazione
| Titolo | Tipo di modifica |
|---|---|
| dotnet.acquire API per VS Code non sempre scarica più la versione più recente | Cambiamento comportamentale |
Interoperabilità
| Titolo | Tipo di modifica |
|---|---|
| Il cast dell'oggetto COM IDispatchEx in IReflect ha esito negativo | Cambiamento comportamentale |
| Le app a file singolo non cercano più librerie native nella directory eseguibile | Cambiamento comportamentale |
| Se si specifica DllImportSearchPath.AssemblyDirectory, viene eseguita solo la ricerca nella directory dell'assembly | Cambiamento comportamentale |
Rete
| Titolo | Tipo di modifica |
|---|---|
| Supporto HTTP/3 disabilitato per impostazione predefinita con PublishTrimmed | Origine non compatibile |
| Lo streaming delle risposte HTTP è abilitato per impostazione predefinita nei client del browser HTTP | Cambiamento comportamentale |
Uri limiti di lunghezza rimossi |
Cambiamento comportamentale |
Riflessione
| Titolo | Tipo di modifica | Versione introdotta |
|---|---|---|
| Annotazioni più limitate in InvokeMember/FindMembers/DeclaredMembers | Comportamento/origine non compatibile |
SDK e MSBuild
Serializzazione
| Titolo | Tipo di modifica |
|---|---|
| System.Text.Json verifica la presenza di conflitti di nomi di proprietà | Cambiamento comportamentale |
| XmlSerializer non ignora più le proprietà contrassegnate con ObsoleteAttribute | Cambiamento comportamentale |
Windows Forms
| Titolo | Tipo di modifica |
|---|---|
| Obsolescenze delle API | Origine non compatibile |
| Applicazioni che fanno riferimento sia a WPF che a WinForms devono disambiguare i tipi MenuItem e ContextMenu | Origine non compatibile |
| Parametro rinominato in HtmlElement.InsertAdjacentElement | Origine non compatibile |
| troncamento dell'immagine della casella di controllo di TreeView | Cambiamento comportamentale |
| StatusStrip usa System RenderMode per impostazione predefinita | Cambiamento comportamentale |
| System.Drawing OutOfMemoryException è stato modificato in ExternalException | Cambiamento comportamentale |
WPF (Windows Presentation Foundation)
| Titolo | Tipo di modifica |
|---|---|
| ColumnDefinitions e RowDefinitions vuoti non sono consentiti | Origine non compatibile |
| L'utilizzo non corretto di DynamicResource causa l'arresto anomalo dell'applicazione | Modifica incompatibile/comportamentale della sorgente |
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
