Breaking Changes in .NET 11

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

In diesem Artikel werden die einzelnen Breaking Changes als mit der Binärdatei inkompatibel, mit der Quelle inkompatibel oder als Verhaltensänderung kategorisiert:

  • Binärdatei inkompatibel: Wenn sie mit der neuen Runtime oder Komponente ausgeführt werden, kann bei vorhandenen Binärdateien ein Breaking Change im Verhalten auftreten, z. B. Fehler beim Laden oder Ausführen. In diesem Fall müssen sie erneut kompiliert werden.

  • Quelle inkompatibel: Bei der Neukompilierung mit dem neuen SDK oder der neuen Komponente oder zur Ausrichtung auf die neue Runtime sind für vorhandenen Quellcode möglicherweise Quelländerungen erforderlich, damit die Kompilierung erfolgreich ist.

  • Verhaltensänderung – Vorhandene Code- und Binärdateien verhalten sich zur Laufzeit möglicherweise anders. Wenn das neue Verhalten unerwünscht ist, muss vorhandener Code aktualisiert und neu kompiliert werden.

Hinweis

Dies ist nicht die endgültige Fassung dieses Artikels. Nicht alle Breaking Changes für .NET 11 werden hier aufgeführt.

Kernbibliotheken .NET

Title Art der Änderung
CRC32-Überprüfung beim Lesen von ZIP-Archiveinträgen hinzugefügt Verhaltensänderung
DateOnly- und TimeOnly-TryParse-Methoden werden für ungültige Eingaben ausgelöst Verhaltensänderung
DeflateStream und GZipStream schreiben Kopf- und Fußzeilen für leere Nutzlast Verhaltensänderung
Environment.TickCount wurde an das Timeout-Verhalten von Windows angepasst Verhaltensänderung
Maximale Kapazität von MemoryStream aktualisiert und Ausnahmeverhalten geändert Verhaltensänderung
NamedPipeServerStream mit PipeOptions.CurrentUserOnly strafft Unix-Socketdateiberechtigungen Verhaltensänderung
Nullable.GetUnderlyingType löst bei benutzerdefinierten Unterklassen von „Type” einen Fehler aus Verhaltensänderung
Veraltete APIs ohne Standarddiagnose-IDs (.NET 11) Inkompatible Quelle
TAR-Lese-APIs überprüfen Header-Prüfsummen beim Lesen Verhaltensänderung
TarWriter verwendet HardLink-Einträge für hart verknüpfte Dateien Verhaltensänderung
ZipArchive.CreateAsync lädt zip-Archiveinträge eifrig Verhaltensänderung

Kryptografie

Title Art der Änderung
DSA wurde aus macOS entfernt Verhaltensänderung

Erweiterungen

Title Art der Änderung
IHost.RunAsync und IHost.StopAsync werden ausgelöst, wenn ein BackgroundService fehlschlägt Verhaltensänderung

Globalisierung

Title Art der Änderung
Minimales unterstütztes Datum des japanischen Kalenders korrigiert Verhaltensänderung

Interop

Title Art der Änderung
NativeAOT verwendet lib-Präfix für systemeigene Bibliotheksausgaben auf Unix Verhaltensänderung

JIT-Compiler

Title Art der Änderung
Mindesthardwareanforderungen aktualisiert Verhaltensänderung

Networking

Title Art der Änderung
SslStream serverseitige AIA-Zertifikatdownloads standardmäßig deaktiviert Verhaltensänderung

.NET MAUI

Title Art der Änderung
Minimale Android-API-Ebene auf 24 erhöht Verhaltensänderung

SDK und MSBuild

Title Art der Änderung
mono-Startziel für .NET Framework-Apps nicht festgelegt Verhaltensänderung
VSTest entfernt abhängigkeit von Newtonsoft.Json Binär/Quelle inkompatibel
  • Last updated on