Modifiche di rilievo in .NET 10

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:

  • 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 critici in .NET 10.

ASP.NET Core

Consulta Modifiche importanti in ASP.NET Core 10.

Containers

Titolo Tipo di modifica
Le immagini .NET predefinite usano Ubuntu Cambiamento comportamentale
Dotnet test richiede una directory di base degli artefatti VSTest scrivibile nei contenitori Cambiamento comportamentale

Principali librerie .NET

Titolo Tipo di modifica
Obsolescenze API Origine non compatibile
Modifica del comportamento di ActivitySource.CreateActivity e ActivitySource.StartActivity Cambiamento comportamentale
I caricamenti senza fault di Arm64 SVE richiedono la maschera File binario/origine non compatibile
BufferedStream.WriteByte non esegue più il flush implicito Cambiamento comportamentale
Risoluzione dell'overload C# 14 con parametri span Cambiamento comportamentale
Comportamento coerente dello spostamento nell'aritmetica generica Cambiamento comportamentale
Propagatore di contesto di traccia predefinito aggiornato allo standard W3C Cambiamento comportamentale
DriveInfo.DriveFormat restituisce tipi di file system Linux Cambiamento comportamentale
Annotazione DynamicallyAccessedMembers rimossa dal ctor DefaultValueAttribute File binario/origine non compatibile
Dimensione esplicita della struct non consentita con InlineArray Incompatibilità binaria
FilePatternMatch.Stem modificato per essere non nullable Modifica incompatibile/comportamentale della sorgente
GnuTarEntry e PaxTarEntry non includono più atime e ctime per impostazione predefinita Cambiamento comportamentale
L'analisi sintattica di LDAP DirectoryControl è ora più rigorosa Cambiamento comportamentale
Normalizzazione della versione MacCatalyst Cambiamento comportamentale
I mutex denominati hanno come impostazione predefinita l'ambito utente in Unix Cambiamento comportamentale
.NET runtime non fornisce più gestori di segnale di terminazione predefiniti Cambiamento comportamentale
System.Linq.AsyncEnumerable è incluso nelle librerie principali Origine non compatibile
Convalida degli argomenti di Type.MakeGenericSignatureType Cambiamento comportamentale

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 richiesto su Unix Cambiamento comportamentale
La convalida X500DistinguishedName è più restrittiva Cambiamento comportamentale
I parametri di 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)

Consulta Modifiche di rilievo in EF Core 10.

Extensions

Titolo Tipo di modifica
BackgroundService esegue tutte le operazioni di ExecuteAsync come Task 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 spostato nell'assembly Microsoft.Extensions.Logging.Abstractions Origine non compatibile
Rimozione dell'annotazione DynamicallyAccessedMembers dal codice Microsoft.Extensions.Configuration trim-unsafe 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 scarica più sempre 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 dell'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
MailAddress applica la convalida per i punti consecutivi Cambiamento comportamentale
Risposte HTTP in streaming abilitate per impostazione predefinita nei client HTTP del browser 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
Validazione degli argomenti di Type.MakeGenericSignatureType Cambiamento comportamentale

SDK e MSBuild

Titolo Tipo di modifica
.NET CLI --interactive è impostato per impostazione predefinita su true negli scenari utente Cambiamento comportamentale
dotnet I comandi dell'interfaccia della riga di comando registrano dati non rilevanti per i comandi in stderr Cambiamento comportamentale
La creazione di pacchetti di strumenti .NET crea pacchetti di strumenti specifici per RuntimeIdentifier Cambiamento comportamentale
La configurazione predefinita del carico di lavoro passa da "manifest separati" alla modalità "set di carico di lavoro" Cambiamento comportamentale
DefineConstants per i framework di destinazione non disponibili al momento della valutazione Cambiamento comportamentale
Il valore predefinito di Code coverage EnableDynamicNativeInstrumentation è false Cambiamento comportamentale
gli script dnx aggirano la selezione dell'SDK di global.json Cambiamento comportamentale
dnx.ps1 file non è più incluso in .NET SDK Origine non compatibile
Le virgolette doppie nelle direttive a livello di file non sono consentite Origine non compatibile
dotnet new sln usa per impostazione predefinita il formato di file SLNX Cambiamento comportamentale
dotnet package list esegue il ripristino Cambiamento comportamentale
dotnet restore verifica i pacchetti transitivi Cambiamento comportamentale
dotnet tool install --local crea il manifest per impostazione predefinita Cambiamento comportamentale
dotnet watch registra in stderr invece di stdout Cambiamento comportamentale
project.json non è supportato in dotnet restore Origine non compatibile
Supporto delle impronte SHA-1 deprecato in dotnet nuget sign Cambiamento comportamentale
Rimozione della soluzione alternativa MSBUILDCUSTOMBUILDEVENTWARNING Cambiamento comportamentale
Gestione delle risorse delle impostazioni cultura personalizzate di MSBuild Cambiamento comportamentale
NU1510 viene generato per i riferimenti diretti eliminati da NuGet Origine non compatibile
I pacchetti NuGet senza asset di runtime non sono inclusi in deps.json Origine non compatibile
PackageReference senza una versione genera un errore Cambiamento comportamentale
PrunePackageReference privatizza i riferimenti diretti eliminabili Cambiamento comportamentale
Avvisi HTTP promossi a errori in dotnet package list e dotnet package search Modifica non compatibile del comportamento/della sorgente
NUGET_ENABLE_ENHANCED_HTTP_RETRY variabile di ambiente rimossa Cambiamento comportamentale
Le origini di verifica NuGet non consentono più HTTP non sicuro per impostazione predefinita Cambiamento comportamentale
NuGet registra un errore per gli ID pacchetto non validi Cambiamento comportamentale
ToolCommandName non impostato per i pacchetti non tool Origine non compatibile
L'installazione del pacchetto modello verifica le firme NuGet Cambiamento comportamentale

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 API Origine non compatibile
Le applicazioni che fanno riferimento sia macchine virtuali Windows che 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 TreeView Cambiamento comportamentale
StatusStrip usa System RenderMode per impostazione predefinita Cambiamento comportamentale
System.Drawing OutOfMemoryException è stato modificato in ExternalException Cambiamento comportamentale

macchine virtuali Windows (Windows Presentation Foundation)

Titolo Tipo di modifica
ColumnDefinitions vuoti 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