Zásadní změny v .NET 11

Pokud migrujete aplikaci na .NET 11, můžou vás tyto zásadní změny ovlivnit. Změny jsou seskupené podle oblasti technologií, například ASP.NET Core nebo model Windows Forms.

Tento článek kategorizuje každou zásadní změnu jako binárně nekompatibilní nebo zdrojově nekompatibilní, nebo jako změnu v chování:

  • Binarita je nekompatibilní – při spuštění v novém runtime nebo komponentě mohou existující binární soubory narazit na zásadní změnu chování, jako je selhání při načítání nebo spuštění, a v takovém případě vyžadují rekompilaci.

  • Zdroj nekompatibilní – Při opětovném zkompilování pomocí nové sady SDK nebo komponenty nebo cílení na nový modul runtime může stávající zdrojový kód vyžadovat úspěšné kompilace zdrojových změn.

  • Změna chování – Existující kód a binární soubory se můžou chovat jinak za běhu. Pokud je nové chování nežádoucí, stávající kód bude potřeba aktualizovat a znovu zkompilovat.

Poznámka:

Tento článek probíhá. Nejedná se o úplný seznam zásadních změn v .NET 11.

ASP.NET Core

Viz zásadní změny v ASP.NET Core 11.

Základní knihovny .NET

Title Typ změny
CborReader a CborWriter vynucují výchozí maximální hloubku vnoření. Změna chování
Ověření CRC32 přidáno při čtení položek archivu ZIP Změna chování
Metody DateOnly a TimeOnly TryParse vyhazují výjimku pro neplatný vstup Změna chování
DeflateStream a GZipStream zapisují hlavičky a zápatí pro prázdný datový blok Změna chování
Environment.TickCount bylo sladěno s chováním časového limitu Windows Změna chování
NamedPipeServerStream s PipeOptions.CurrentUserOnly zpřísní oprávnění k souborům soketu Unix Změna chování
Nullable.GetUnderlyingType vyvolá pro vlastní podtřídy typů Změna chování
Obsoletní rozhraní API s nediagnostickými ID (.NET 11) Nekompatibilní zdroj
SafeFileHandle.IsAsync a FileStream.IsAsync přesně odrážejí neblokující stav v systému Unix. Změna chování
Rozhraní API pro čtení TAR při čtení ověřují kontrolní součty hlaviček Změna chování
TarWriter používá položky HardLink pro pevně propojené soubory. Změna chování
ZipArchive.CreateAsync dychtivě načte položky archivu ZIP Změna chování

Cryptography

Title Typ změny
Zastaralost rozhraní API Nekompatibilní zdroj
DSA bylo odstraněno z macOS Změna chování

Deployment

Title Typ změny
configProperties v souboru .runtimeconfig.dev.json přepisují hodnoty v souboru .runtimeconfig.json Změna chování

Extensions

Title Typ změny
Vyvolání IHost.RunAsync a IHost.StopAsync v případě selhání služby BackgroundService Změna chování
Některé balíčky Microsoft.Extensions zahrnuté ve sdílené architektuře Změna chování

Globalization

Title Typ změny
Datum opravy minimálního podporovaného data japonského kalendáře Změna chování

Interop

Title Typ změny
NativeAOT používá předponu knihovny lib pro výstupy nativní knihovny v Unixu. Změna chování

kompilátor JIT

Title Typ změny
Aktualizované minimální požadavky na hardware Změna chování

Sítě

Title Typ změny
Stahování certifikátů AIA na straně serveru SslStream ve výchozím nastavení je zakázané Změna chování

.NET MAUI

Title Typ změny
Minimální úroveň rozhraní ANDROID API zvýšená na 24 Změna chování

SDK a MSBuild

Title Typ změny
Skripty dnx obcházejí výběr SDK v souboru global.json Změna chování
cílový objekt spuštění Mono není nastaven pro aplikace .NET Framework Změna chování
NU1703 varuje před balíčky, které používají zastaralé prostředky architektury MonoAndroid Nekompatibilní zdroj
Balíčky modulu šablon už nepodporují netstandard2.0 Binární nebo zdroj nekompatibilní
VSTest odebere závislost na Newtonsoft.Json. Binární nebo zdroj nekompatibilní