Breaking Changes in .NET 5

Wenn Sie eine App zu .NET 5 migrieren, können sich die hier aufgeführten wichtigen Änderungen auf Sie auswirken. Änderungen werden nach Technologiebereich gruppiert, z. B. ASP.NET Core oder Kryptografie.

In diesem Artikel wird angegeben, ob jede breaking change binär kompatibel oder Quell kompatibel ist.

  • Binärkompatibel : Vorhandene Binärdateien werden ohne erneute Kompilierung erfolgreich geladen und ausgeführt, und das Laufzeitverhalten ändert sich nicht.
  • Source compatible - Source compatible - Source code will compile successfully without changes when targeting the new runtime or using the new SDK or component.

ASP.NET Core

Weitere Informationen finden Sie unter "Grundlegende Änderungen in ASP.NET Core 5".

Codeanalyse

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

.NET-Kernbibliotheken

Titel Binärkompatibel Quellkompatibel
Assemblybezogene API-Änderungen für die Single-File-Veröffentlichung ❌ ✔️
BinaryFormatter Serialization-Methoden sind veraltet ✔️ ❌
Codezugriffssicherheits-APIs sind veraltet ✔️ ❌
CreateCounterSetInstance löst InvalidOperationException aus. ✔️ ❌
"Standard-ActivityIdFormat" ist "W3C" ❌ ✔️
Environment.OSVersion gibt die richtige Version zurück. ❌ ✔️
Der Wert von FrameworkDescription ist .NET nicht .NET Core ✔️ ❌
GAC-APIs sind veraltet ✔️ ❌
Hardwareinterne IsSupported-Prüfungen ❌ ✔️
IntPtr und UIntPtr implementieren IFormattable ✔️ ❌
LastIndexOf verarbeitet leere Suchzeichenfolgen ❌ ✔️
URI-Pfade mit Nicht-ASCII-Zeichen auf Unix ❌ ✔️
API-Veraltungen mit nicht standardmäßigen Diagnose-IDs ✔️ ❌
Veraltete Eigenschaften auf ConsoleLoggerOptions ✔️ ❌
Komplexität von LINQ OrderBy.First ❌ ✔️
Microsoft.DotNet.PlatformAbstractions-Paket entfernt ❌ ✔️
PrincipalPermissionAttribute ist veraltet ✔️ ❌
Parameternamenänderungen in Referenzassemblys ✔️ ❌
Remoting-APIs sind veraltet ❌ ✔️
Die Reihenfolge der Liste "Activity.Tags" ist umgekehrt. ✔️ ❌
SSE- und SSE2-Vergleichsmethoden behandeln NaN ✔️ ❌
Thread.Abort ist veraltet ✔️ ❌
URI-Erkennung von UNC-Pfaden auf Unix ❌ ✔️
UTF-7-Codepfade sind veraltet ✔️ ❌
Verhaltensänderung für Vector2.Lerp und Vector4.Lerp ✔️ ❌
Vector<T> löst NotSupportedException aus ❌ ✔️

Kryptographie

Titel Binärkompatibel Quellkompatibel
Kryptografie-APIs werden im Browser nicht unterstützt ❌ ✔️
Cryptography.Oid ist nur bei der Initialisierung festlegbar ✔️ ❌
Standardmäßige TLS-Cipher Suites unter Linux ❌ ✔️
Create() Overloads für kryptografische Abstraktionen sind veraltet ✔️ ❌
Standardmäßiger FeedbackSize-Wert wurde geändert ✔️ ❌

Entity Framework Core (ein Framework zum Arbeiten mit Datenbanken)

Siehe Grundlegende Änderungen in EF Core 5.0.

Globalisierung

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

Interoperabilität

Titel Binärkompatibel Quellkompatibel
Die Unterstützung für WinRT wird entfernt. ❌ ✔️
Umwandlung von RCW in InterfaceIsIInspectable löst Ausnahme aus ❌ ✔️
Keine A/W-Suffix-Prüfung auf Nicht-Windows-Plattformen ❌ ✔️

Vernetzung

Titel Binärkompatibel Quellkompatibel
Die Verarbeitung von Cookiepfaden entspricht RFC 6265 ✔️ ❌
LocalEndPoint wird nach dem Aufrufen von SendToAsync aktualisiert. ✔️ ❌
MulticastOption.Group akzeptiert Null nicht ✔️ ❌
Datenströme ermöglichen aufeinander folgende Begin-Vorgänge ❌ ✔️
WinHttpHandler wurde aus .NET Laufzeit entfernt ❌ ✔️

Softwareentwicklungskit (SDK)

Titel Binärkompatibel Quellkompatibel
Standardmäßig importierte Directory.Packages.props-Dateien ❌ ✔️
Fehler, der generiert wird, wenn ein ausführbares Projekt auf eine nicht übereinstimmende ausführbare Datei verweist ✔️
FrameworkReference wurde für Windows SDK durch WindowsSdkPackageVersion ersetzt ✔️ ❌
NETCOREAPP3_1 Präprozessorsymbol nicht definiert ✔️ ❌
OutputType ist auf WinExe festgelegt ❌ ✔️
PublishDepsFilePath-Verhaltensänderung ❌ ✔️
TargetFramework-Änderung von netcoreapp zu net ❌ ✔️
WinForms und WPF Apps verwenden Microsoft.NET.Sdk ❌ ✔️

Sicherheit

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

Serialisierung

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

Windows Forms

Titel Binärkompatibel Quellkompatibel
Systemeigener Code kann nicht auf Windows Forms Objekte zugreifen ✔️ ❌
OutputType ist auf WinExe festgelegt ❌ ✔️
DataGridView setzt keine benutzerdefinierten Schriftarten 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 ❌ ✔️
Entfernte Statusleistensteuerelemente ✔️ ❌

WPF (Windows Presentation Foundation)

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

Siehe auch