Breaking Changes in ASP.NET Core 11

Wenn Sie eine App zu ASP.NET Core 11 migrieren, können sich die hier aufgeführten änderungen auf Sie auswirken.

In diesem Artikel werden die einzelnen Breaking Changes als auf Binärebene inkompatibel, mit dem Quellcode inkompatibel oder als Verhaltensänderung kategorisiert:

  • Binär inkompatibel: Wenn sie mit der neuen Runtime oder Komponente ausgeführt werden, kann bei vorhandenen Binärdateien eine einschneidende Änderung im Verhalten auftreten, zum Beispiel Probleme 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.

Titel Art der Änderung
Blazor Benutzerdefinierte Ereignisregistrierung wird ausgelöst, wenn der Name mit einem Browserereignis übereinstimmt Verhaltensänderung
Blazor Erweiterte Navigation lädt keine Ressourcen mehr vor. Verhaltensänderung
ConcurrencyLimiter Middleware entfernt Binär/Quelle inkompatibel
Beim Hosting werden standardmäßig OpenTelemetry-HTTP-Semantikkonventionstags ausgegeben. Verhaltensänderung
Kestrel Verschärft die HTTP-Protokollcompliance Verhaltensänderung
Microsoft. OpenApi wurde auf 3.x Inkompatible Quelle
Veraltete Blazor APIs entfernt Inkompatible Quelle
Das OpenAPI-Dokument enthält alle "ProducesResponseType"-Einträge pro Statuscode. Verhaltensänderung
Die OpenAPI-Server-URL hat keinen abschließenden Schrägstrich mehr, wenn PathBase leer ist. Verhaltensänderung
Die Passkey-Anmeldung erzwingt E-Mail-/Telefonbestätigung und Sperrung Verhaltensänderung
Die Antwortkomprimierung gibt immer Vary: Accept-Encoding aus Verhaltensänderung
SqlClient Active Directory Authentifizierung in ein separates Paket verschoben Verhaltensänderung
WebAssemblyHostBuilder lädt Umgebungsvariablen in IConfiguration Verhaltensänderung