Iron Suite for .NET

10 .NET-Bibliotheken. Eine komplette Dokumenten-Suite.

BRANCHENMELDUNGEN

Umstieg auf .NET 11? Überprüfen Sie zuerst diese Breaking Changes

Curtis Chau
Curtis Chau
Aktualisiert: 31. August 2026

.NET 11 steht kurz bevor, und die Liste der Breaking Changes ist bereits verfügbar. Wir haben sie Zeile für Zeile durchgearbeitet, damit Sie beim Upgrade wissen, worauf Sie achten müssen.

Das sind gute Nachrichten, aber es macht auch die Migrationstests wichtiger.

Viele Anwendungen werden nach der Umstellung auf .NET 11 immer noch problemlos kompiliert. Das größere Risiko besteht in Verhaltensänderungen: Code, der erfolgreich kompiliert, aber eine neue Ausnahme auslöst, Daten anders verarbeitet oder zur Laufzeit leicht unterschiedliche Ergebnisse liefert.

Anstatt jeden Kompatibilitätspunkt einzeln durchzugehen, konzentriert sich dieser Leitfaden auf die Änderungen, die echte Anwendungen am ehesten betreffen, und darauf, was Sie testen sollten, bevor Sie in die Produktion gehen.

Alles in einer Tabelle

ÄnderungWas passiert
ZIP-Lesen validiert CRC32Wirft InvalidDataException bei beschädigten Einträgen
DateOnly/TimeOnly TryParseWirft bei ungültigem Format oder Stil
BackgroundService FehlerHost wirft beim Start/Herunterfahren
Math.Round KorrektheitGibt korrekt gerundete Ergebnisse zurück
Erweiterungen im gemeinsamen FrameworkAuflösung der Assembly-Version kann sich verschieben
Build- und Test-ToolsVSTest, NuGet, Template-Engine-Änderungen

Die, die wir zuerst überprüfen würden: ZIP-Lesen wirft jetzt

Dies ist die Änderung, die eine dokumentenlastige Codebasis am ehesten überraschen könnte, da sie still ist, bis sie es nicht mehr ist. Ab .NET 11 validiert System.IO.Compression die CRC32-Prüfsumme, wenn Sie einen ZIP-Eintrag lesen, und wirft InvalidDataException, wenn die gespeicherte Prüfsumme nicht mit den Daten übereinstimmt. Zuvor wurde ein beschädigter oder manipulierte Eintrag ohne Beanstandung gelesen.

Das ist eine wirklich gute Änderung, Sie möchten wissen, wann eine Datei schlecht ist, aber wenn Ihre App ZIP-Dateien von Benutzern, Partnern oder einem alten Speicher-Bucket einliest, kann Code, der jahrelang "funktionierte", plötzlich Ausnahmen auslösen. Die Lösung ist klein: Wickeln Sie Ihr Lesen in einen Try-Catch für InvalidDataException und entscheiden Sie, wie Sie mit einem schlechten Archiv umgehen möchten. Besser, es absichtlich zu fangen, als es in der Produktion zu entdecken.

Die heimtückische: TryParse kann jetzt werfen

Jeder .NET-Entwickler hat verinnerlicht, dass TryParse niemals wirft, sondern einen bool zurückgibt. In .NET 11 brechen DateOnly.TryParse, TimeOnly.TryParse und ihre TryParseExact-Geschwister diese Gewohnheit leicht: Geben Sie einen ungültigen DateTimeStyles-Wert oder einen schlechten Formatbezeichner an, und sie werfen jetzt ArgumentException, anstatt stillschweigend false zurückzugeben. Wenn Ihre Formatzeichenfolgen und Stile fest codiert und gültig sind, ändert sich nichts. Wenn sie zur Laufzeit berechnet oder von Benutzereingaben stammen, ist dies ein neuer Ausnahmeweg, den es zu berücksichtigen gilt.

Überprüfen Sie nur, wenn es Ihre Welt ist

Der Rest ist enger gefasst und nach ihrem Standort gruppiert:

  • ASP.NET Core. Alte Blazor-APIs, die vor Jahren als veraltet markiert wurden, kompilieren nicht mehr. Kestrel ist strenger bei fehlerhaften HTTP-Headern. Und wenn Ihre SQL-Verbindungszeichenfolge Entra ID (Active Directory) Authentifizierung verwendet, benötigen Sie jetzt das Microsoft.Data.SqlClient.Extensions.Azure-Paket, dies betrifft auch EF Core SQL Server-Benutzer.
  • Erweiterungen und Hosting. Worker-Dienste schlagen lauter fehl: Wenn ein BackgroundService wirft, wirft auch der Host, also testen Sie Ihren Startpfad.
  • Kernbibliotheken. Math.Round und komplexe Zahlen wurden standardgerechter, was nur dann von Bedeutung ist, wenn Tests die alten Werte erwarten.
  • Build und Tools. VSTest lässt Newtonsoft.Json fallen, Template-Pakete lassen netstandard2.0 fallen. Diese treten als Build-Fehler auf, also kündigen sie sich selbst an.
  • Plattform. Die Mindestanforderungen an die CPU sind gestiegen, .NET MAUI benötigt Android API 24, und das Abrufen von TLS-Serverzertifikaten ist standardmäßig deaktiviert. Sie werden wissen, ob das auf Sie zutrifft.

Eine Sache, über die Sie sich keine Sorgen machen müssen

Während Sie Abhängigkeiten auf die Bereitschaft für .NET 11 prüfen, sollte Ihr Dokumenten-Tooling nicht auf der Liste stehen. Die Iron Suite Bibliotheken sind reine verwaltete .NET und laufen bereits über .NET 11 bis .NET Framework, sodass IronPDF, IronXL und der Rest der Suite mit Ihrer App mitziehen, anstatt sie zu blockieren. Bemerkenswert, da die oben erwähnte ZIP-Änderung direkt neben der Art von Dateiverarbeitungscode liegt, den diese Bibliotheken ersetzen. Wenn Sie selbstgeschriebene Dokumenten- oder Archivlösungen haben, ist eine Migration ein natürlicher Moment, um diesen Teil an eine Bibliothek zu übergeben, die bereits jede .NET-Version verfolgt.

Für die vollständige Liste, einschließlich der ASP.NET Core-Änderungen, die auf ihrer eigenen Seite leben, ist die Microsoft .NET 11 Breaking Changes Reference die Quelle, die Sie als Lesezeichen speichern sollten. Wir werden diesen Beitrag aktualisieren, sobald diese Liste wächst, da sie noch ergänzt wird.