Breaking Changes in .NET 6
Wenn Sie eine App zu .NET 6 migrieren, sind Sie möglicherweise von den hier aufgeführten Breaking Changes betroffen. Änderungen werden nach Technologiebereich gruppiert, z. B. ASP.NET Core oder Windows Forms.
In diesem Artikel werden die einzelnen Änderungsänderungen als inkompatible Binärdatei oder Quelle kategorisiert:
- Binärkompatible - Vorhandene Binärdateien können auf eine unterbrechungsfreie Änderung des Verhaltens stoßen, z. B. fehler beim Laden oder Ausführen, oder auf ein anderes Laufzeitverhalten.
- Inkompatible Quelle – Quellcode kann bei der Ausrichtung auf die neue Laufzeit oder verwendung des neuen SDK oder der neuen Komponente auf eine unterbrechungsfreie Änderung des Verhaltens stoßen. Verhaltensänderungen können Kompilierungsfehler oder unterschiedliche Laufzeitverhalten umfassen.
Hinweis
Dies ist nicht die endgültige Fassung dieses Artikels. Nicht alle Breaking Changes für .NET 6 werden hier aufgeführt. Informationen zu noch nicht veröffentlichten Breaking Changes finden Sie unter Issues of .NET.
ASP.NET Core
Container
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Standardformatierung der Konsolenprotokollierung in Containerimages | ✔️ | ❌ | Wartung 6.0.6 |
Weitere Informationen zu anderen unterbrechungsweisen Änderungen für Container in .NET 6 finden Sie unter .NET 6 Container Release Notes.
Core .NET-Bibliotheken
Kryptografie
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
CreateEncryptor-Methoden lösen Ausnahme bei falscher Feedbackgröße aus | ❌ | ✔️ | Preview 7 |
Bereitstellung
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
x86-Hostpfad unter 64-Bit-Windows | ✔️ | ✔️ | Wartungsversion |
Entity Framework Core
Erweiterungen
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Überprüfen des Nicht-NULL-Anbieters durch AddProvider | ✔️ | ❌ | RC 1 |
Ausgabe von InvalidDataException durch FileConfigurationProvider.Load | ✔️ | ❌ | RC 1 |
Ausnahme durch Lösen eines verworfenen ServiceProviders | ✔️ | ❌ | RC 1 |
Globalisierung
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Kulturerstellung und Zuordnung von Groß-/Kleinbuchstaben im globalisierungsinvarianten Modus | Preview 7 |
Interop
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Statische abstrakte Member in Schnittstellen | ❌ | ✔️ | Preview 7 |
JIT-Compiler
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Coerce-Aufrufargumente gemäß ECMA-335 | ✔️ | ✔️ | Vorschauversion 1 |
Netzwerk
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Port aus SPN für Kerberos und Negotiate entfernt | ❌ | ✔️ | RC 1 |
WebRequest, WebClient und ServicePoint sind veraltet. | ✔️ | ❌ | Vorschauversion 1 |
SDK
Serialisierung
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Standardserialisierungsformat für TimeSpan | ❌ | ✔️ | Wartung 6.0.2 |
IAsyncEnumerable-Serialisierung | ✔️ | ❌ | Vorschauversion 4 |
Refactoring der Quellgenerierungs-API für JSON | ❌ | ✔️ | RC 2 |
JsonNumberHandlingAttribute in Auflistungseigenschaften | ❌ | ✔️ | RC 1 |
Neue JsonSerializer-Quellgeneratorüberladungen | ❌ | ✔️ | Vorschau 6 |
Windows Forms
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
C#-Vorlagen verwenden Anwendungsbootstrap | ✔️ | ❌ | RC 1 |
Ausgewählte TableLayoutSettings-Eigenschaften, die eine InvalidEnumArgumentException-Ausnahme auslösen | ❌ | ✔️ | Vorschauversion 1 |
Mit DataGridView verbundene APIs lösen jetzt InvalidOperationException aus | ❌ | ✔️ | Vorschauversion 4 |
ListViewGroupCollection-Methoden lösen neue InvalidOperationException aus | ❌ | ✔️ | RC 2 |
Maximale Textlänge für NotifyIcon.Text erhöht | ❌ | ✔️ | Vorschauversion 1 |
ScaleControl wird nur bei Bedarf aufgerufen | ✔️ | ❌ | Wartung 6.0.101 |
Manche APIs lösen ArgumentNullException aus | ❌ | ✔️ | Vorschau 1–4 |
TreeNodeCollection.Item löst eine Ausnahme aus, wenn der Knoten an anderer Stelle zugewiesen wird. | ❌ | ✔️ | Vorschauversion 1 |