Kompatibilitást megszakító változások a .NET 11-ben

Ha egy alkalmazást a .NET 11-re migrál, az itt felsorolt módosítások hatással lehetnek Önre. A módosítások technológiai terület szerint vannak csoportosítva, például ASP.NET Core vagy Windows Forms.

Ez a cikk az egyes kompatibilitástörő változásokat binárisan nem kompatibilisként vagy nem kompatibilis forrásként, illetve viselkedési változásként kategorizálja:

• Bináris inkompatibilis – Ha az új futtatókörnyezeten vagy összetevőn fut, a meglévő bináris fájlok működésbeli kompatibilitástörő változásba ütközhetnek, például nem tölthetők be vagy hajthatók végre, és ha igen, újrafordítást igényelnek.

• Forrás nem kompatibilis – Ha újra fordítják az új SDK-val vagy összetevővel, vagy az új futtatókörnyezet célzásával, előfordulhat, hogy a meglévő forráskód sikeres fordításához módosításokra van szükség.

• Viselkedésbeli változás – A meglévő kód és bináris fájlok futásidőben eltérően viselkedhetnek. Ha az új viselkedés nem kívánatos, a meglévő kódot frissíteni és újra kell lefordítani.

Megjegyzés:

Ez a cikk egy folyamatban lévő munka. Ez nem a .NET 11 megszakító változásainak teljes listája.

ASP.NET Core

Lásd: Kompatibilitástörő változások az ASP.NET Core 11-ben.

Alapvető .NET-kódtárak

Cím	A módosítás típusa
A CborReader és a CborWriter alapértelmezett maximális beágyazási mélységet kényszerít	Viselkedésbeli változás
CRC32-ellenőrzés hozzáadva ZIP-archívumbejegyzések olvasásakor	Viselkedésbeli változás
A DateOnly és a TimeOnly TryParse metódus érvénytelen bemenetet eredményez	Viselkedésbeli változás
A DeflateStream és a GZipStream üres hasznos adathoz fejléceket és élőlábat ír.	Viselkedésbeli változás
Environment.TickCount összhangban lett Windows időtúllépési viselkedéssel	Viselkedésbeli változás
NamedPipeServerStream with PipeOptions.CurrentUserOnly megszigorítja a Unix szoftvercsatornák fájlengedélyeit	Viselkedésbeli változás
Nullable.GetUnderlyingType kivételt dob egyéni típus alosztályok esetén	Viselkedésbeli változás
API elavulások nem alapértelmezett diagnosztikai azonosítókkal (.NET 11)	A forrás nem kompatibilis
A SafeFileHandle.IsAsync és a FileStream.IsAsync pontosan tükrözi a Unix nem blokkoló állapotát	Viselkedésbeli változás
A TAR-olvasási API-k ellenőrzik a fejléc ellenőrzőösszegeit olvasáskor	Viselkedésbeli változás
A TarWriter HardLink-bejegyzéseket használ a rögzített fájlokhoz	Viselkedésbeli változás
A ZipArchive.CreateAsync lelkesen betölti a ZIP-archívum bejegyzéseit	Viselkedésbeli változás

Kriptográfia

Cím	A módosítás típusa
API-k elavulása	A forrás nem kompatibilis
DSA eltávolítva a macOS-ből	Viselkedésbeli változás
A Linux AIA-tanúsítvány lekérése lánc buildenként legfeljebb két lekérésre korlátozódik	Viselkedésbeli változás

Telepítés

Cím	A módosítás típusa
A .runtimeconfig.dev.json fájlban lévő configProperties felülbírálják a .runtimeconfig.json fájlban lévőket	Viselkedésbeli változás

bővítmények

Cím	A módosítás típusa
A ChangeToken.OnChange async túlterheli a meglévő feladat-visszahívásokat	Viselkedésbeli változás
Az IHost.RunAsync és az IHost.StopAsync dobása a BackgroundService meghiúsulásakor	Viselkedésbeli változás
A megosztott keretrendszerben foglalt néhány Microsoft.Extensions-csomag	Viselkedésbeli változás

Globalization

Cím	A módosítás típusa
A japán naptár minimálisan támogatott dátuma javítva	Viselkedésbeli változás

Interop

Cím	A módosítás típusa
A NativeAOT a Unix natív kódtár-kimeneteihez használja a lib előtagot	Viselkedésbeli változás

igény szerinti fordító

Cím	A módosítás típusa
Minimális hardverkövetelmények frissítve	Viselkedésbeli változás

hálózat

Cím	A módosítás típusa
Az SslStream kiszolgálóoldali AIA-tanúsítvány letöltése alapértelmezés szerint le van tiltva	Viselkedésbeli változás

.NET MAUI

Cím	A módosítás típusa
Az Android API minimális szintje 24-esre emelve	Viselkedésbeli változás

SDK és MSBuild

Cím	A módosítás típusa
Dnx-szkriptek megkerülik global.json SDK-kijelölést	Viselkedésbeli változás
mono indítási cél nincs beállítva .NET Framework-alkalmazásokhoz	Viselkedésbeli változás
A NativeAOT CLI parancskezelése alapértelmezés szerint engedélyezve van	Viselkedésbeli változás
A NU1703 figyelmeztet az elavult MonoAndroid-keretrendszer-eszközöket használó csomagokra	A forrás nem kompatibilis
A NuGet-csomag a korlátozott karaktereket tartalmazó csomagazonosítókra figyelmeztet	Viselkedésbeli változás
A sablonmotor-csomagok már nem támogatják a netstandard2.0-t	Bináris/forrás inkompatibilis
A VSTest eltávolítja a Newtonsoft.Json-függőséget	Bináris/forrás inkompatibilis