Breaking Changes in .NET 5

Bewertung abgeben

Haben Sie weiteres Feedback für uns?

Feedback wird an Microsoft gesendet: Wenn Sie auf die Sendeschaltfläche klicken, wird Ihr Feedback verwendet, um Microsoft-Produkte und -Dienste zu verbessern. Datenschutzrichtlinie

Wenn Sie eine App zu .NET 5 migrieren, sind Sie möglicherweise von den hier aufgeführten Breaking Changes betroffen. Änderungen werden nach Technologiebereich gruppiert, z. B. ASP.NET Core oder Kryptografie.

ASP.NET Core

Titel	Binärkompatibel	Quellkompatibel
ASP.NET Core-Apps deserialisieren Zahlen in Anführungszeichen.	✔️	❌
Die APIs AzureAD.UI und AzureADB2C.UI sind veraltet.	✔️	❌
Die BinaryFormatter-Serialisierungsmethoden sind veraltet.	✔️	❌
Die Ressource im Endpunktrouting ist HttpContext	✔️	❌
Azure-Integrationspakete mit Präfix „Microsoft“ entfernt	❌	✔️
Blazor: Logik für die Routingrangfolge in Blazor-Apps geändert	✔️	❌
Blazor: Aktualisierte Browserunterstützung	✔️	✔️
Blazor: Unbedeutende Leerzeichen, die vom Compiler entfernt wurden	✔️	❌
Blazor: Die JSObjectReference- und JSInProcessObjectReference-Typen sind intern.	✔️	❌
Blazor: Das Zielframework von NuGet-Paketen wurde geändert	❌	✔️
Blazor: Feature ProtectedBrowserStorage wurde in das freigegebene Framework verschoben	✔️	❌
Blazor: Schreibgeschützte öffentliche RenderTreeFrame-Felder sind jetzt Eigenschaften.	❌	✔️
Blazor: Aktualisierte Validierungslogik für statische Webressourcen	❌	✔️
Kryptografie-APIs werden im Browser nicht unterstützt.	❌	✔️
Erweiterungen: Paketverweisänderungen	❌	✔️
BadHttpRequestException-Typen für Kestrel und IIS sind veraltet.	✔️	❌
HttpClient-Instanzen, die von IHttpClientFactory erstellt wurden, protokollieren Integerstatuscodes	✔️	❌
HttpSys: Erneute Aushandlung für Clientzertifikate standardmäßig deaktiviert	✔️	❌
IIS: Abfragezeichenfolgen für die UrlRewrite-Middleware werden beibehalten	✔️	❌
Kestrel: Standardmäßig erkannte Konfigurationsänderungen	✔️	❌
Kestrel: Standardmäßig unterstützte TLS-Protokollversionen geändert	✔️	❌
Kestrel: HTTP/2 über TLS ist für nicht kompatible Windows-Versionen deaktiviert	✔️	✔️
Kestrel: Markierung von libuv-Transport als veraltet	✔️	❌
Veraltete Eigenschaften in ConsoleLoggerOptions	✔️	❌
ResourceManagerWithCultureStringLocalizer-Klasse und WithCulture-Schnittstellenmember entfernt	✔️	❌
„Pubternal“-APIs entfernt	✔️	❌
Ein veralteter Konstruktor wurde in der Middleware für Anforderungslokalisierung entfernt	✔️	❌
Middleware: Datenbankfehlerseite als veraltet markiert	✔️	❌
Ausnahmehandlermiddleware löst ursprüngliche Ausnahme aus	✔️	✔️
ObjectModelValidator ruft eine neue Überladung von Validate auf	✔️	❌
Die Codierung für Cookienamen wurde entfernt	✔️	❌
Die Versionen des IdentityModel-NuGet-Pakets wurden aktualisiert	❌	✔️
SignalR: Optionstyp für das MessagePack-Hubprotokoll geändert	✔️	❌
SignalR: Hub-Protokoll „MessagePack“ wurde verschoben	✔️	❌
UseSignalR- und UseConnections-Methoden entfernt	✔️	❌
CSV-Inhaltstyp in standardkonform geändert	✔️	❌

Codeanalyse

Titel	Binärkompatibel	Quellkompatibel
CA1416-Warnung	✔️	❌
CA1417-Warnung	✔️	❌
CA1831-Warnung	✔️	❌
CA2013-Warnung	✔️	❌
CA2014-Warnung	✔️	❌
CA2015-Warnung	✔️	❌
CA2200-Warnung	✔️	❌
CA2247-Warnung	✔️	❌

Core .NET-Bibliotheken

Titel	Binärkompatibel	Quellkompatibel
Assemblybezogene API-Änderungen für Veröffentlichung einer einzelnen Datei	❌	✔️
Die BinaryFormatter-Serialisierungsmethoden sind veraltet.	✔️	❌
Codezugriffssicherheit-APIs sind veraltet.	✔️	❌
CreateCounterSetInstance löst InvalidOperationException aus.	✔️	❌
Das ActivityIdFormat-Standardformat ist W3C	❌	✔️
Environment.OSVersion gibt die richtige Version aus.	❌	✔️
Der Wert von FrameworkDescription entspricht „.NET“ und nicht „.NET Core“.	✔️	❌
Die GAC-APIs sind veraltet.	✔️	❌
Hardwareinterne IsSupported-Überprüfungen	❌	✔️
IntPtr und UIntPtr implementieren IFormattable	✔️	❌
LastIndexOf behandelt leere Suchzeichenfolgen.	❌	✔️
URI-Pfade mit Nicht-ASCII-Zeichen auf UNIX	❌	✔️
Veraltete APIs ohne Standarddiagnose-IDs	✔️	❌
Veraltete Eigenschaften in ConsoleLoggerOptions	✔️	❌
Komplexität von OrderBy.First in LINQ	❌	✔️
OSPlatform-Attribute wurden umbenannt oder entfernt	✔️	❌
Das Paket Microsoft.DotNet.PlatformAbstractions wurde entfernt	❌	✔️
PrincipalPermissionAttribute ist veraltet	✔️	❌
Parameternamensänderungen aus Vorschauversionen	✔️	❌
Änderung des Parameternamen in Verweisassemblys	✔️	❌
Remoting-APIs sind veraltet	❌	✔️
Reihenfolge der „Activity.Tags“-Liste ist umgekehrt.	✔️	❌
SSE- und SSE2-Vergleichsmethoden behandeln NaN.	✔️	❌
Thread.Abort ist veraltet	✔️	❌
URI-Erkennung von UNC-Pfaden unter UNIX	❌	✔️
UTF-7-Codepfade sind veraltet	✔️	❌
Behavior Change für Vector2.Lerp und Vector4.Lerp	✔️	❌
Vector<T> löst „NotSupportedException“ aus	❌	✔️

Kryptografie

Titel	Binärkompatibel	Quellkompatibel
Kryptografie-APIs werden im Browser nicht unterstützt.	❌	✔️
Cryptography.Oid ist nur init.	✔️	❌
TLS-Standardverschlüsselungssuites unter Linux	❌	✔️
Create()-Überladungen für kryptografische Abstraktionen sind veraltet.	✔️	❌
Der Standardwert für FeedbackSize wurde geändert.	✔️	❌

Entity Framework Core

Breaking Changes in EF Core 5.0

Globalisierung

Titel	Binärkompatibel	Quellkompatibel
Verwenden von ICU-Bibliotheken unter Windows	❌	✔️
StringInfo und TextElementEnumerator sind mit UAX29 kompatibel.	❌	✔️
Geänderte Unicode-Kategorie für Zeichen in Lateinisch-1	✔️	❌
TextInfo.ListSeparator-Werte geändert	✔️	❌

Interop

Titel	Binärkompatibel	Quellkompatibel
Die Unterstützung für WinRT wurde entfernt.	❌	✔️
Bei Umwandlung von RCW in InterfaceIsIInspectable wird eine Ausnahme ausgelöst.	❌	✔️
Keine A/W-Überprüfung des Suffixes auf anderen Plattformen als Windows	❌	✔️

Netzwerk

Titel	Binärkompatibel	Quellkompatibel
Verarbeitung von Cookiepfaden ist mit RFC 6265 konform.	✔️	❌
LocalEndPoint wird nach dem Aufrufen von SendToAsync aktualisiert	✔️	❌
MulticastOption.Group akzeptiert keine NULL-Werte.	✔️	❌
Streams ermöglichen aufeinanderfolgende Begin-Vorgänge.	❌	✔️
Entfernung von WinHttpHandler aus der .NET-Runtime	❌	✔️

SDK

Titel	Binärkompatibel	Quellkompatibel
Directory.Packages.props-Dateien werden standardmäßig importiert.	❌	✔️
Fehler wird generiert, wenn ausführbares Projekt auf nicht übereinstimmendes ausführbares Projekt verweist		✔️
FrameworkReference wurde durch WindowsSdkPackageVersion für Windows SDK ersetzt	✔️	❌
NETCOREAPP3_1-Präprozessorsymbol nicht definiert	✔️	❌
OutputType auf WinExe festgelegt	❌	✔️
Behavior Change von PublishDepsFilePath	❌	✔️
TargetFramework-Änderung von „netcoreapp“ in „net“	❌	✔️
WinForms- und WPF-Apps verwenden Microsoft.NET.Sdk	❌	✔️

Sicherheit

Titel	Binärkompatibel	Quellkompatibel
Codezugriffssicherheit-APIs sind veraltet.	✔️	❌
PrincipalPermissionAttribute ist veraltet	✔️	❌
UTF-7-Codepfade sind veraltet	✔️	❌

Serialisierung

Titel	Binärkompatibel	Quellkompatibel
Ausnahmen für BinaryFormatter.Deserialize-Umbrüche	✔️	❌
JsonSerializer.Deserialize erfordert Zeichenfolgen mit einzelnem Zeichen	✔️	❌
ASP.NET Core-Apps deserialisieren Zahlen in Anführungszeichen.	✔️	❌
JsonSerializer.Serialize löst ArgumentNullException aus.	✔️	❌
Nicht öffentliche parameterlose Konstruktoren, die nicht für die Deserialisierung verwendet werden	✔️	❌
Beim Serialisieren von Schlüssel-Wert-Paaren werden Optionen berücksichtigt.	✔️	❌

Windows Forms

Titel	Binärkompatibel	Quellkompatibel
Nativer Code kann nicht auf Windows Forms-Objekte zugreifen.	✔️	❌
OutputType auf WinExe festgelegt	❌	✔️
DataGridView setzt benutzerdefinierte Schriftarten nicht zurück.	✔️	❌
Methoden lösen ArgumentException aus.	✔️	❌
Methoden lösen ArgumentNullException aus.	✔️	❌
Eigenschaften lösen ArgumentOutOfRangeException aus.	✔️	❌
TextFormatFlags.ModifyString ist veraltet	✔️	❌
DataGridView-APIs lösen InvalidOperationException aus.	✔️	❌
WinForms-Apps verwenden Microsoft.NET.Sdk.	❌	✔️
Statusleisten-Steuerelement wurde entfernt	✔️	❌

WPF

Titel	Binärkompatibel	Quellkompatibel
OutputType auf WinExe festgelegt	❌	✔️
WPF-Apps verwenden Microsoft.NET.Sdk.	❌	✔️