Identität: Bootstrap-Standardversion der Benutzeroberfläche geändert

2025-06-18

Ab ASP.NET Core 6.0 verwendet die Identitäts-UI standardmäßig Version 5 von Bootstrap. ASP.NET Core 3.0 bis 5.0 verwendete Version 4 von Bootstrap.

Eingeführte Version

ASP.NET Core 6.0

Verhalten

AddDefaultIdentity<TUser>(IServiceCollection) ruft die interne private Methode TryResolveUIFramework auf. TryResolveUIFramework liest UIFramework aus der Anwendungsassembly. Die UIFramework Standardversion lautet:

Bootstrap 5 für das .NET 6 SDK
Bootstrap 4 für .NET Core 3.1 und .NET 5 SDK

Von der Vorlage erstellte ASP.NET Core 3.1- und 5.0-Apps enthalten Bootstrap 4 in wwwroot\lib\bootstrap. Von Vorlagen erstellte ASP.NET Core 6-Apps verwenden Bootstrap 5. Wenn eine ASP.NET Core 3.1- oder 5.0-App zu .NET 6 migriert wird, erkennt UIFramework die Anwendung Version 5, während wwwroot\lib\bootstrap Version 4 enthält. Diese Versionsabweichung führt dazu, dass die Identity-Vorlagen nicht ordnungsgemäß dargestellt werden.

Grund für Änderung

Bootstrap 5 wurde während des ASP.NET Core 6.0-Zeitrahmens veröffentlicht.

Empfohlene Aktion

Apps, die von dieser Änderung betroffen sind, verwenden die Standard-Identitäts-Benutzeroberfläche und haben sie, wie im folgenden Code gezeigt, in Startup.ConfigureServices hinzugefügt.

services.AddDefaultIdentity<IdentityUser>()

Führen Sie eine der folgenden Aktionen aus:

Fügen Sie die MSBuild-Eigenschaft IdentityUIFrameworkVersion in der Projektdatei hinzu, und geben Sie Bootstrap 4 an:
```
<PropertyGroup>
  <TargetFramework>net6.0</TargetFramework>
  <IdentityUIFrameworkVersion>Bootstrap4</IdentityUIFrameworkVersion>
</PropertyGroup>
```
Im vorherigen Markup wird die UIFramework Version auf Bootstrap 4 festgelegt, die gleiche Bootstrap-Version wie in ASP.NET Core 3.1 und 5.0 verwendet.
Benennen Sie den Ordner "wwwroot\lib\bootstrap" um oder löschen Sie ihn und ersetzen ihn durch den Ordner "wwwroot\lib\bootstrap" aus einer von einer ASP.NET Core 6-Vorlage generierten App. Die Identitätsvorlagen funktionieren mit dieser Änderung, aber Apps, die Bootstrap verwenden, müssen möglicherweise auf das Bootstrap 5-Migrationshandbuch verweisen.

Betroffene APIs

AddDefaultIdentity<TUser>(IServiceCollection)

Freigeben über