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 wird erläutert, ob jeder Breaking Change binärkompatibel oder quellkompatibel ist:
- Binärkompatibel: Vorhandene Binärdateien werden ohne Neukompilierung geladen und ausgeführt, und das Laufzeitverhalten ändert sich nicht.
- Quellkompatibel: Der Quellcode wird ohne Änderungen erfolgreich kompiliert, wenn er auf die neue Runtime abzielt oder das neue SDK oder die neue Komponente verwendet.
ASP.NET Core
Container
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Standardformatierung der Konsolenprotokollierung in Containerimages | ✔️ | ❌ | Wartung 6.0.6 |
Informationen zu anderen Breaking Changes für Container in .NET 6 finden Sie unter .NET 6 Container Release Notes (Versionshinweise zu .NET 6-Containern).
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 |
Wiederholte XML-Elemente enthalten einen Index | ❌ | ✔️ | |
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 |
---|---|---|---|
DataContractSerializer behält beim Deserialisieren von -0 das Vorzeichen bei | ❌ | ✔️ | Wartung 6.0.11 |
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 |
XML und XSLT
Titel | Binärkompatibel | Quellkompatibel | Eingeführt |
---|---|---|---|
Änderung der NULL-Zulässigkeit bei XmlDocument.XmlResolver | ❌ | ✔️ | RC 1 |
XNodeReader.GetAttribute-Verhalten für ungültigen Index | ✔️ | ❌ | Vorschau 2 |
Siehe auch
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
.NET feedback
The .NET documentation is open source. Provide feedback here.
Feedback
Feedback senden und anzeigen für