Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Pokud migrujete aplikaci na .NET 10, můžou vás tyto zásadní změny ovlivnit. Změny jsou seskupené podle oblasti technologií, jako je ASP.NET Core nebo Windows Forms.
Tento článek kategorizuje každou změnu způsobující chybu jako binární nekompatibilní nebo nekompatibilní zdroj nebo jako behaviorální změnu:
Binární nekompatibilní – Při spuštění s novým runtime nebo komponentou mohou existující binární soubory narazit na kritickou změnu chování, například selhání při načítání nebo spuštění, a pokud ano, 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.
Note
Tento článek probíhá. Nejedná se o úplný seznam zásadních změn v .NET 10.
ASP.NET Core
| Title | Typ změny |
|---|---|
| Přesměrování přihlášení k souborům cookie pro známé koncové body rozhraní API | Změna chování |
| Vyřazení metody rozšíření WithOpenApi | Nekompatibilní zdroj |
| Diagnostika výjimek potlačená, když TryHandleAsync vrátí hodnotu true | Změna chování |
| IActionContextAccessor a ActionContextAccessor jsou zastaralé | Nekompatibilní/behaviorální změna zdroje |
| Vlastnost IncludeOpenAPIAnalyzers a analyzátory rozhraní API MVC jsou zastaralé | Nekompatibilní zdroj |
| IpNetwork a ForwardedHeadersOptions.KnownNetworks jsou zastaralé | Nekompatibilní zdroj |
| Balíček Microsoft.Extensions.ApiDescription.Client je zastaralý | Nekompatibilní zdroj |
| Razor Kompilace modulu runtime je zastaralá. | Nekompatibilní zdroj |
| WebHostBuilder, IWebHost a WebHost jsou zastaralé | Nekompatibilní zdroj |
Containers
| Title | Typ změny |
|---|---|
| Výchozí image .NET používají Ubuntu | Změna chování |
Základní knihovny .NET
Cryptography
| Title | Typ změny |
|---|---|
| CompositeMLDsa aktualizováno na verzi návrhu 08 | Změna chování |
| CoseSigner.Key může mít hodnotu null. | Behaviorální/zdroj nekompatibilní změna |
| Přejmenování členů MLDsa a SlhDsa SecretKey | Nekompatibilní zdroj |
| Kryptografické primitivy OpenSSL se v macOS nepodporují. | Změna chování |
| OpenSSL 1.1.1 nebo novější vyžadované v systému Unix | Změna chování |
| Ověření X500DistinguishedName je přísnější | Změna chování |
| Parametry klíče X509Certificate a PublicKey můžou mít hodnotu null. | Behaviorální/zdroj nekompatibilní změna |
| Proměnná prostředí byla přejmenována na DOTNET_OPENSSL_VERSION_OVERRIDE | Změna chování |
Entity Framework Core
Extensions
| Title | Typ změny |
|---|---|
| BackgroundService spouští všechny executeAsync jako úlohu. | Změna chování |
| Oprava problémů s GetKeyedService() a GetKeyedServices() pomocí AnyKey | Změna chování |
| Hodnoty null zachované v konfiguraci | Změna chování |
| Zpráva se už ve výstupu protokolu konzoly nezdvojila | Změna chování |
| ProviderAliasAttribute přesunuto do sestavení Microsoft.Extensions.Logging.Abstractions | Nekompatibilní zdroj |
| Byla odstraněna anotace DynamickyAccessedMembers z kódu Microsoft.Extensions.Configuration, který není bezpečný pro ořezávání | Binární nekompatibilní |
Globalization
| Title | Typ změny |
|---|---|
| Proměnná prostředí byla přejmenována na DOTNET_ICU_VERSION_OVERRIDE | Změna chování |
Nástroj pro instalaci
| Title | Typ změny |
|---|---|
| dotnet.acquire API pro VS Code už ne vždy stahuje nejnovější | Změna chování |
Interop
| Title | Typ změny |
|---|---|
| Přetypování COM objektu IDispatchEx na IReflect selže | Změna chování |
| Jednosouborové aplikace už nehledají nativní knihovny ve spustitelném adresáři. | Změna chování |
| Určení DllImportSearchPath.AssemblyDirectory prohledá pouze adresář sestavení. | Změna chování |
Sítě
| Title | Typ změny |
|---|---|
| Podpora HTTP/3 je ve výchozím nastavení zakázaná s funkcí PublishTrimmed | Nekompatibilní zdroj |
| Streamování odpovědí HTTP povolených ve výchozím nastavení v klientech HTTP prohlížeče | Změna chování |
Uri odebrané limity délky |
Změna chování |
Zamyšlení
| Title | Typ změny | Představená verze |
|---|---|---|
| Další omezené poznámky pro InvokeMember/FindMembers/DeclaredMembers | Chování / zdroj nekompatibilní |
SDK a MSBuild
Serialization
| Title | Typ změny |
|---|---|
| System.Text.Json kontroluje konflikty názvů vlastností. | Změna chování |
| XmlSerializer už ignoruje vlastnosti označené zastaralou atributem ObsoleteAttribute. | Změna chování |
model Windows Forms
| Title | Typ změny |
|---|---|
| Zastaralost rozhraní API | Nekompatibilní zdroj |
| Aplikace odkazující na WPF i WinForms musí zrušit nejednoznačnost typů MenuItem a ContextMenu. | Nekompatibilní zdroj |
| Přejmenování parametru v HtmlElement.InsertAdjacentElement | Nekompatibilní zdroj |
| Zkrácení obrázku zaškrtávacího pole v TreeView | Změna chování |
| StatusStrip ve výchozím nastavení používá system RenderMode. | Změna chování |
| System.Drawing OutOfMemoryException se změnil na ExternalException | Změna chování |
Windows Presentation Foundation (WPF)
| Title | Typ změny |
|---|---|
| Prázdné definice columnDefinitions a RowDefinitions jsou zakázány | Nekompatibilní zdroj |
| Nesprávné použití DynamicResource způsobuje chybové ukončení aplikace | Nekompatibilní/behaviorální změna zdroje |
Spolupracujte s námi na GitHubu
Zdroj tohoto obsahu najdete na GitHubu, kde můžete také vytvářet a kontrolovat problémy a žádosti o přijetí změn. Další informace najdete v našem průvodci pro přispěvatele.
