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 runtime eller komponenten kan befintliga binärfiler stöta på en brytande beteendeförändring, till exempel att det inte går att ladda eller exekvera, och så behövs omkompilering.

• Källkod inkompatibel – Vid omkompilering med den nya SDK:n eller komponenten eller för att inrikta sig på den nya körmiljön, kan existerande källkod behöva ändringar för att kompileras korrekt.

• Beteendeförändring – Befintlig kod och binärfiler kan bete sig annorlunda under 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.

Core .NET-bibliotek

Titel	Typ av ändring
CRC32-validering har lagts till när zip-arkivposter läss	Beteendeförändring
DateOnly- och TimeOnly TryParse-metoder genererar ogiltiga indata	Beteendeförändring
DeflateStream- och GZipStream skriver headers och footers för tomma nyttolaster	Beteendeförändring
Environment.TickCount överensstämmer med Windows timeout-beteende	Beteendeförändring
Minnesströmmens maximala kapacitet har uppdaterats och undantagsbeteendet har ändrats	Beteendeförändring
Nullable.GetUnderlyingType kastar för subklasser av typen	Beteendeförändring
API-obsoletioner med diagnostik-ID som inte är standard (.NET 11)	Källan är inkompatibel
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
ZipArchive.CreateAsync laddar omedelbart ZIP-arkivinnehåll	Beteendeförändring

Cryptography

Titel	Typ av ändring
DSA har tagits bort från macOS	Beteendeförändring

Extensions

Titel	Typ av ändring
IHost.RunAsync och IHost.StopAsync genererar när en BackgroundService misslyckas	Beteendeförändring

Globalization

Titel	Typ av ändring
Det lägsta stödda datumet för den japanska kalendern har korrigerats	Beteendeförändring

Interop

Titel	Typ av ändring
NativeAOT använder lib-prefix för inbyggda biblioteksutdata i Unix	Beteendeförändring

JIT-kompilator

Titel	Typ av ändring
Lägsta maskinvarukrav har uppdaterats	Beteendeförändring

Networking

Titel	Typ av ändring
SslStream-AIA-certifikatnedladdningar på serversidan är inaktiverade som standard	Beteendeförändring

SDK och MSBuild

Titel	Typ av ändring
mono-startmålet har inte angetts för .NET Framework-appar	Beteendeförändring