Icke-bakåtkompatibla ändringar i .NET 11

Om du migrerar en app till .NET 11 kan de icke-bakåtkompatibla ändringarna som anges här påverka dig. Ändringar grupperas efter teknikområde, till exempel ASP.NET Core eller Windows Forms.

Den här artikeln kategoriserar varje ändring som binärt inkompatibel eller källinkompatibel, eller som en beteendeförändring:

  • Binärt inkompatibelt – När det körs mot den nya körningen eller komponenten kan befintliga binärfiler stöta på en icke-bakåtkompatibel beteendeförändring, till exempel att det inte går att läsa in eller köra, och i så fall kräva omkompilering.

  • Inkompatibel källa – När den omkompileras med den nya SDK:n eller komponenten eller för att rikta in sig på den nya körningen kan befintlig källkod kräva källändringar för att kompileras korrekt.

  • Beteendeförändring – Befintlig kod och binärfiler kan bete sig annorlunda vid körning. Om det nya beteendet är oönskat måste befintlig kod uppdateras och kompileras om.

Anmärkning

Den här artikeln är ett pågående arbete. Det är inte en fullständig lista över breaking changes i .NET 11.

ASP.NET Core

Se Breaking changes in ASP.NET Core 11.

Containers

Titel Typ av ändring
dotnet test behöver en skrivbar VSTest-artefaktbaskatalog i containrar Beteendeförändring

Core .NET-bibliotek

Titel Typ av ändring
Assembly.GetCallingAssembly-beteende ändras när stöd för stackspårning är inaktiverat Beteendeförändring
CborReader och CborWriter tillämpar ett maximalt kapslingsdjup som standard Beteendeförändring
Komplexa specialvärdesresultat följer nu C23 Bilaga G Beteendeförändring
CRC32-validering har lagts till när zip-arkivposter läss Beteendeförändring
DateOnly- och TimeOnly TryParse-metoder kastar ett undantag vid ogiltiga indata Beteendeförändring
Decimal- och BigInteger-flyttalskonverteringar avrundas korrekt Beteendeförändring
DeflateStream- och GZipStream-skrivhuvuden och sidfötter för tom nyttolast Beteendeförändring
Environment.GetCommandLineArgs()[0] bevarar apphost-anropsnamnet Beteendeförändring
Environment.TickCount är konsekvent med Windows timeout-beteende Beteendeförändring
Genererade WMI-samlings- och uppräkningsomslutningar implementerar IDisposable Käll- eller beteendeförändring
Math.Round och MathF.Round returnerar korrekt avrundade resultat Beteendeförändring
Namngivna mutexes som standard för användaromfång i Unix Beteendeförändring
NamedPipeServerStream med PipeOptions.CurrentUserOnly skärper behörigheterna för Unix-domänsocketfiler Beteendeförändring
Nullable.GetUnderlyingType genererar för anpassade typunderklasser Beteendeförändring
PackagePart.GetStream() returnerar en icke-sökbar dataström för komprimerade delar i ReadWrite-paket Beteendeförändring
API:er som blir föråldrade med icke-standarddiagnostik-ID:n (.NET 11) Källan är inkompatibel
SafeFileHandle.IsAsync och FileStream.IsAsync återspeglar korrekt icke-blockerande tillstånd i Unix Beteendeförändring
API:er för TAR-läsning verifierar sidhuvudkontrollsummor vid läsning Beteendeförändring
TarWriter använder HardLink-poster för hårdlänkade filer Beteendeförändring
Tensor-åtgärder anpassar motsvarande former och tomma tensorer Beteendeförändring
Tensor-åtgärder avvisar lagringslayouter som inte stöds Beteendeförändring
ZipArchive.CreateAsync läser omedelbart in ZIP-arkivposter Beteendeförändring

Cryptography

Titel Typ av ändring
API-utfasningar Källan är inkompatibel
Sammansatt ML-DSA på Windows använder inbyggd implementering Beteendeförändring
DSA har tagits bort från macOS Beteendeförändring
HKDF på Windows använder CNG-implementering Beteendeförändring
Hämtning av Linux AIA-certifikat begränsad till två hämtningar per kedjebyggnad Beteendeförändring

Driftsättning

Titel Typ av ändring
konfigurationEgenskaper i .runtimeconfig.dev.json åsidosätter .runtimeconfig.json Beteendeförändring

Extensions

Titel Typ av ändring
ChangeToken.OnChange asynkrona överlagringar ombinder befintliga återanrop som returnerar Task Beteendeförändring
Undantag för disponering av beroendeinjektionsomfång aggregerar undantag Beteendeförändring
Tomma strängar i länkad konfiguration åsidosätter tidigare providers Beteendeförändring
FileConfigurationProvider utlöser inte någon omladdningstoken efter ignorerat inläsningsfel Beteendeförändring
FileConfigurationSource.OnLoadException-återanrop anropas för I/O-fel Beteendeförändring
IHost.RunAsync och IHost.StopAsync utlöser ett undantag när en BackgroundService misslyckas Beteendeförändring
Generatorn för alternativvalidering rapporterar SYSLIB1205 för explicita valideringsimplementeringar Källan är inkompatibel
PhysicalFilesWatcher validerar roten och FileSystemWatcher-sökvägar Beteendeförändring
Några Microsoft.Extensions-paket som ingår i ett delat ramverk Beteendeförändring

Globalization

Titel Typ av ändring
Lägsta datum för japansk kalender som stöds har korrigerats Beteendeförändring

Interop

Titel Typ av ändring
Native AOT avvisar icke-blittable UnmanagedCallersOnly-signaturer Beteendeförändring
NativeAOT använder lib-prefix för utdata för interna bibliotek i Unix Beteendeförändring

JIT-kompilator

Titel Typ av ändring
Flyttalskonverteringar till små integraltyper är saturerande Beteendeförändring
Lägsta maskinvarukrav har uppdaterats Beteendeförändring

Networking

Titel Typ av ändring
HttpClient-mått med hög kardinalitet använder observerbara räknare Beteendeförändring
SslStream-AIA-certifikatnedladdningar på serversidan är inaktiverade som standard Beteendeförändring

.NET MAUI

Titel Typ av ändring
Android x86 stöds inte Binär inkompatibel och beteendemässig förändring
Kodgenerering på mobiler ändras från Mono till CoreCLR Källinkompatibel/beteendeförändring
CoreCLR ersätter Mono runtime för .NET mobilappar Binär/källinkompatibel/beteendeförändring
CoreCLR-spårningshändelser ersätter Mono-spårningshändelser Binär/källinkompatibel/beteendeförändring
Ändringar i kraschrapporteringsbeteendet på mobila plattformar Beteendeförändring
Felsökningsgränssnitt på mobila plattformar ändras till ICorDebug Binär/källinkompatibel/beteendeförändring
Lägsta Android API-nivå höjdes till 24 Beteendeförändring
Mono-inbäddnings-API:er stöds inte längre på mobila plattformar Binär/källinkompatibel/beteendeförändring
Egenskaper för monoprojekt konfigurerar inte längre mobilappar Källinkompatibel/beteendeförändring
Inställningar för Mono runtime konfigurerar inte längre mobilappar Beteende-/källkompatibel
UnwindNativeCode stöds inte på Apple-mål Källinkompatibel/beteendeförändring

SDK och MSBuild

Titel Typ av ändring
dnx-skripten kringgår global.json SDK-val Beteendeförändring
Fullständigt bygge utelämnades för Native AOT-publicering Beteendeförändring
mono-startmål har inte angetts för .NET Framework-appar Beteendeförändring
NativeAOT CLI-kommandohantering aktiverad som standard Beteendeförändring
NU1703 varnar för paket som använder inaktuella MonoAndroid-ramverkstillgångar Källan är inkompatibel
NuGet-låskatalogen har flyttats på Linux Beteendeförändring
NuGet pack varnar för paket-ID:n med begränsade tecken Beteendeförändring
Återställ söker inte i mappen globala paket efter högre version Källan är inkompatibel
Val av lokal containerkörning för SDK:n använder helst plattformsanpassade verktyg Beteendeförändring
Mallmotorpaket stöder inte längre netstandard2.0 Binär/källinkompatibel
Installation av mallpaket verifierar NuGet-signaturer Beteendeförändring
VSTest tar bort beroendet av Newtonsoft.Json Binär/källinkompatibel