Breaking Changes in .NET 7

Artikel
08/17/2023

Wenn Sie eine App zu .NET 7 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

Titel	Binärkompatibel	Quellkompatibel
API-Controlleraktionen versuchen, Parameter aus der Abhängigkeitsinjektion (DI) rückzuschließen	✔️	❌
Rangfolge Präfixumgebungsvariable mit ASPNET-Präfix	✔️	✔️
AuthenticateAsync für Remoteauthentifizierungsanbieter	✔️	❌
Authentifizierung in WebAssembly-Apps	❌	✔️
Standardauthentifizierungsschema	❌	✔️
Ereignis-IDs für einige „Microsoft.AspNetCore.Mvc.Core“-Protokollmeldungen geändert	❌	✔️
Fallbackdateiendpunkte	❌	✔️
IHubClients und IHubCallerClients blenden Mitglieder aus	✔️	❌
Kestrel: Standardmäßige HTTPS-Bindung entfernt	❌	✔️
Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv und libuv.dll entfernt	❌	❌
Update für Microsoft.Data.SqlClient auf 4.0.1	✔️	❌
Middleware wird für Endpunkte mit NULL-Anforderungsdelegat nicht mehr zurückgestellt	❌	✔️
MVC-Erkennung eines leeren Texts in der Modellbindung geändert	❌	✔️
Änderungen an der Ausgabecache-API	❌	❌
SignalR-Hub-Methoden versuchen, Parameter aus Abhängigkeitsinjektion (DI) aufzulösen	✔️	❌

Core .NET-Bibliotheken

Titel	Binärkompatibel	Quellkompatibel
Veraltete APIs mit Standarddiagnose-ID	✔️	❌
Veraltete APIs ohne Standarddiagnose-IDs	✔️	❌
BinaryFormatter-Serialisierungs-APIs erzeugen Compilerfehler	✔️	❌
BrotliStream lässt definierte CompressionLevel-Werte nicht mehr zu	❌	✔️
C++-/CLI-Projekte in Visual Studio	✔️	❌
Änderungen an Reflexion rufen API-Ausnahmen auf	❌	✔️
Entladbare Assembly in nicht entladbarem AssemblyLoadContext	❌	✔️
Änderung der Genauigkeit von DateTime-Additionsmethoden	✔️	✔️
Entspricht der Änderung des Methodenverhaltens für NaN	❌	✔️
EventSource-Rückrufverhalten	✔️	✔️
Allgemeine Typeinschränkung für PatternContext<T>	❌	❌
FileStream-Legacystrategie entfernt	❌	✔️
Bibliotheksunterstützung für ältere Frameworks	❌	❌
Maximale Genauigkeit für numerische Formatzeichenfolgen	❌	✔️
Regex-Muster mit korrigierten Bereichen	✔️	✔️
SerializationFormat.Binary ist veraltet.	❌	❌
System.Drawing.Common-Konfigurationsoption wurde entfernt	✔️	✔️
NuGet-Paket „System.Runtime.CompilerServices.Unsafe“	✔️	✔️
Zeitfelder in symbolischen Links	❌	✔️
Nachverfolgen verknüpfter Cacheeinträge	❌	✔️
Überprüfen von CompressionLevel für BrotliStream	❌	✔️

Konfiguration

Titel	Binärkompatibel	Quellkompatibel
System.diagnostics-Eintrag in app.config	❌	✔️

Kryptografie

Titel	Binärkompatibel	Quellkompatibel
Entschlüsseln von EnvelopedCms wird nicht doppelt entpackt	❌	✔️
Überprüfungszeit für Dynamic X509ChainPolicy	❌	✔️
X500DistinguishedName-Analyse von Anzeigenamen	❌	✔️

Bereitstellung

Titel	Binärkompatibel	Quellkompatibel
Alle Assemblys werden standardmäßig gekürzt	✔️	❌
Lookup auf mehreren Ebenen deaktiviert	❌	✔️
x86-Hostpfad unter 64-Bit-Windows	✔️	✔️
TrimmerDefaultAction veraltet	✔️	❌

Entity Framework Core

Breaking Changes in EF Core 7

Erweiterungen

Titel	Binärkompatibel	Quellkompatibel
Binden einer Konfiguration an ein Wörterbuch erweitert Werte	✔️	✔️
ContentRootPath für Apps, die von Windows-Shell gestartet werden	❌	✔️
Präfixe von Umgebungsvariablen	❌	✔️

Globalisierung

Titel	Binärkompatibel	Quellkompatibel
Globalisierungs-APIs verwenden ICU-Bibliotheken unter Windows Server	❌	✔️

Interop

Titel	Binärkompatibel	Quellkompatibel
„RuntimeInformation.OSArchitecture“ unter Emulation	❌	✔️

.NET MAUI

Titel	Binärkompatibel	Quellkompatibel
Konstruktoren akzeptieren die Basisschnittstelle anstelle des konkreten Typs	❌	✔️
Entfernung von Flussrichtungshilfsmethoden	❌	❌
Neuer UpdateBackground-Parameter	❌	✔️
ScrollToRequest-Eigenschaft wurde umbenannt	❌	❌
Einige Windows-APIs wurden entfernt	❌	❌

Netzwerk

Titel	Binärkompatibel	Quellkompatibel
AllowRenegotiation: Standardwert ist „false“	❌	❌
Benutzerdefinierte Ping-Nutzlasten unter Linux	❌	✔️
Socket.End-Methoden lösen keine ObjectDisposedException aus.	❌	✔️

SDK und MSBuild

Titel	Binärkompatibel	Quellkompatibel
Automatische Runtime-ID für bestimmte Projekte	✔️	❌
Automatische Runtime-ID nur für die Veröffentlichung	❌	❌
CLI-Konsolenausgabe verwendet UTF-8	❌	❌
Konsolencodierung nach Abschluss nicht UTF-8	❌	✔️
MSBuild-Serialisierung von benutzerdefinierten Typen in .NET 7	❌	❌
Parallele SDK-Installationen	❌	❌
Toolmanifeste im Stammordner	✔️	✔️
Versionsanforderungen für .NET 7 SDK	✔️	✔️
dotnet test: Konvertieren von `-a` in Alias `--arch` anstelle von `--test-adapter-path`	❌	❌
dotnet test: Konvertieren von `-r` in Alias `--runtime` anstelle von `--results-dir`	❌	❌
`--output`-Option ist für Befehle auf Projektmappenebene nicht mehr gültig	❌	❌
Das SDK ruft ResolvePackageDependencies nicht mehr auf	✔️	❌

Serialisierung

Titel	Binärkompatibel	Quellkompatibel
DataContractSerializer behält beim Deserialisieren von -0 das Vorzeichen bei	❌	✔️
Deserialisieren des Versionstyps mit führenden oder nachstehenden Leerzeichen	❌	✔️
JsonSerializerOptions-Kopierkonstruktor enthält JsonSerializerContext	❌	✔️
Polymorphe Serialisierung für Objekttypen	❌	✔️
System.Text.Json-Quellgenerator-Fallback	❌	✔️

Windows Forms

Titel	Binärkompatibel	Quellkompatibel
Veraltete Versionen und Warnungen	✔️	❌
Manche APIs lösen ArgumentNullException aus	❌	✔️

WPF

Titel	Binärkompatibel	Quellkompatibel	Abwärtskompatibel
Verhalten von Drag-and-Drop-Vorgängen in Text-Editoren wiederhergestellt	✔️	✔️	❌

XML und XSLT

Titel	Binärkompatibel	Quellkompatibel
„XmlSecureResolver“ ist veraltet	❌	❌

Freigeben über