Modifiche di rilievo in .NET 11

Se si esegue la migrazione di un'app a .NET 11, 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:

  • Binario incompatibile : quando viene eseguito sul nuovo runtime o componente, i file binari esistenti possono riscontrare una modifica che causa un'interruzione del comportamento, ad esempio un errore di caricamento o esecuzione e, in tal caso, richiedere la ricompilazione.

  • Incompatibile a livello di codice sorgente - quando viene ricompilato usando il nuovo SDK o componente o per specificare come destinazione il nuovo runtime, il codice sorgente esistente potrebbe richiedere modifiche al codice sorgente 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 significativi in .NET 11.

ASP.NET Core

Vedere Modificare le modifiche in ASP.NET Core 11.

Contenitori

Titolo Tipo di modifica
Dotnet test richiede una directory di base degli artefatti VSTest scrivibile nei contenitori Cambiamento comportamentale

Librerie di base .NET

Titolo Tipo di modifica
Il comportamento di Assembly.GetCallingAssembly cambia quando il supporto di analisi dello stack è disabilitato Cambiamento comportamentale
CborReader e CborWriter applicano una profondità di annidamento massima predefinita Cambiamento comportamentale
Risultati speciali complessi seguono ora l'allegato G C23 Cambiamento comportamentale
Convalida CRC32 aggiunta durante la lettura delle voci di archivio ZIP Cambiamento comportamentale
I metodi DateOnly e TimeOnly TryParse generano un'eccezione per l'input non valido Cambiamento comportamentale
Le conversioni da virgola mobile in Decimal e BigInteger vengono arrotondate correttamente Cambiamento comportamentale
DeflateStream e GZipStream scrivono intestazioni e piè di pagina per payload vuoto Cambiamento comportamentale
Environment.GetCommandLineArgs()[0] mantiene il nome della chiamata apphost Cambiamento comportamentale
Environment.TickCount è stato reso coerente con il comportamento di timeout Windows Cambiamento comportamentale
I wrapper dell'enumeratore e della raccolta WMI generati implementano IDisposable Origine/modifica comportamentale
Math.Round e MathF.Round restituiscono risultati arrotondati correttamente Cambiamento comportamentale
I mutex denominati hanno come impostazione predefinita l'ambito utente in Unix Cambiamento comportamentale
NamedPipeServerStream con PipeOptions.CurrentUserOnly restringe le autorizzazioni del file socket Unix Cambiamento comportamentale
Nullable.GetUnderlyingType genera un'eccezione per le sottoclassi personalizzate di Type Cambiamento comportamentale
PackagePart.GetStream() restituisce un flusso non ricercabile per parti compresse nei pacchetti ReadWrite Cambiamento comportamentale
Deprecazioni API con ID di diagnostica non predefiniti (.NET 11) Origine non compatibile
SafeFileHandle.IsAsync e FileStream.IsAsync riflettono accuratamente lo stato di non blocco in Unix Cambiamento comportamentale
Le API di lettura TAR verificano i checksum dell'intestazione durante la lettura Cambiamento comportamentale
TarWriter usa le voci HardLink per i file collegati hard-linked Cambiamento comportamentale
Le operazioni tensor allineano forme equivalenti e tensori vuoti Cambiamento comportamentale
Le operazioni tensor rifiutano layout di archiviazione non supportati Cambiamento comportamentale
ZipArchive.CreateAsync carica immediatamente le voci dell'archivio ZIP Cambiamento comportamentale

Crittografia

Titolo Tipo di modifica
Obsolescenze API Origine non compatibile
La ML-DSA composita in Windows usa l'implementazione nativa Cambiamento comportamentale
DSA rimosso da macOS Cambiamento comportamentale
HKDF su Windows usa l'implementazione CNG Cambiamento comportamentale
Recupero di certificati AIA Linux limitato a due recuperi per ogni creazione della catena Cambiamento comportamentale

Deployment

Titolo Tipo di modifica
configProperties in .runtimeconfig.dev.json override .runtimeconfig.json Cambiamento comportamentale

Estensioni

Titolo Tipo di modifica
Gli overload asincroni di ChangeToken.OnChange ricollegheranno i callback esistenti che restituiscono Task Cambiamento comportamentale
L'eliminazione dell'ambito di dependency injection aggrega le eccezioni Cambiamento comportamentale
Le stringhe vuote nella configurazione concatenata sostituiscono i provider precedenti Cambiamento comportamentale
FileConfigurationProvider non genera il token di ricaricamento dopo l'errore di caricamento ignorato Cambiamento comportamentale
Il callback FileConfigurationSource.OnLoadException viene chiamato per gli errori di I/O Cambiamento comportamentale
IHost.RunAsync e IHost.StopAsync generano un'eccezione quando un oggetto BackgroundService non riesce Cambiamento comportamentale
Il generatore di convalida delle opzioni segnala SYSLIB1205 per le implementazioni esplicite di Validate Origine non compatibile
PhysicalFilesWatcher convalida i percorsi root e di FileSystemWatcher Cambiamento comportamentale
Alcuni pacchetti Microsoft.Extensions inclusi nel framework condiviso Cambiamento comportamentale

Globalization

Titolo Tipo di modifica
Correzione della data minima supportata per il calendario giapponese Cambiamento comportamentale

Interoperabilità

Titolo Tipo di modifica
AOT nativo rifiuta le firme UnmanagedCallersOnly non blittable Cambiamento comportamentale
NativeAOT usa il prefisso lib per gli output della libreria nativa in Unix Cambiamento comportamentale

Compilatore JIT

Titolo Tipo di modifica
Le conversioni a virgola mobile in tipi integrali di piccole dimensioni sono con saturazione Cambiamento comportamentale
Requisiti hardware minimi aggiornati Cambiamento comportamentale

Rete

Titolo Tipo di modifica
Le metriche di cardinalità elevata di HttpClient usano contatori osservabili Cambiamento comportamentale
Download dei certificati AIA lato server di SslStream disabilitati per impostazione predefinita Cambiamento comportamentale

.NET MAUI

Titolo Tipo di modifica
Android x86 non è supportato Modifica binaria non compatibile/comportamentale
La generazione di codice sui dispositivi mobili passa da Mono a CoreCLR Modifica incompatibile/comportamentale della sorgente
CoreCLR sostituisce il runtime Mono per .NET app per dispositivi mobili Modifica incompatibile a livello binario/del codice sorgente/comportamentale
Gli eventi di traccia CoreCLR sostituiscono gli eventi di traccia Mono Modifica incompatibile a livello binario/del codice sorgente/comportamentale
Modifiche al comportamento di segnalazione degli arresti anomali nelle piattaforme per dispositivi mobili Cambiamento comportamentale
Interfacce di debug sulle piattaforme mobili che passano a ICorDebug Modifica incompatibile a livello binario/del codice sorgente/comportamentale
Livello minimo di API Android elevato a 24 Cambiamento comportamentale
Le API di incorporamento Mono non sono più supportate nelle piattaforme per dispositivi mobili Modifica incompatibile a livello binario/del codice sorgente/comportamentale
Le proprietà del progetto Mono non configurano più le app per dispositivi mobili Modifica incompatibile/comportamentale della sorgente
Le impostazioni del runtime Mono non configurano più le applicazioni mobili Comportamento/origine non compatibile
UnwindNativeCode non è supportato nelle destinazioni Apple Modifica incompatibile/comportamentale della sorgente

SDK e MSBuild

Titolo Tipo di modifica
gli script dnx aggirano la selezione dell'SDK di global.json Cambiamento comportamentale
Destinazione di avvio mono non impostata per le app di .NET Framework Cambiamento comportamentale
Gestione dei comandi CLI di NativeAOT abilitata per impostazione predefinita Cambiamento comportamentale
NU1703 avvisa per i pacchetti che usano asset del framework MonoAndroid deprecati Origine non compatibile
directory dei lock di NuGet spostata in Linux Cambiamento comportamentale
NuGet pack avvisa per gli ID del pacchetto con caratteri limitati Cambiamento comportamentale
Il ripristino non esegue la ricerca nella cartella dei pacchetti globali per una versione successiva Origine non compatibile
La selezione del runtime del contenitore locale SDK preferisce gli strumenti nativi della piattaforma Cambiamento comportamentale
I pacchetti del motore di modelli non supportano più netstandard2.0 File binario/origine non compatibile
L'installazione dei pacchetti di modello verifica le firme NuGet Cambiamento comportamentale
VSTest rimuove la dipendenza da Newtonsoft.Json File binario/origine non compatibile