Middleware: Datenbankfehlerseite als veraltet markiert

  • Artikel

Die DatabaseErrorPageMiddleware und die zugehörigen Erweiterungsmethoden wurden in ASP.NET Core 5.0 als veraltet markiert. Die Middleware und Erweiterungsmethoden werden in ASP.NET Core 6.0 entfernt. Die Funktionalität wird stattdessen von DatabaseDeveloperPageExceptionFilter und den zugehörigen Erweiterungsmethoden bereitgestellt.

Weitere Informationen finden Sie unter dem GitHub-Issue dotnet/aspnetcore#24987.

Eingeführt in Version

5.0 RC 1

Altes Verhalten

DatabaseErrorPageMiddleware und die zugehörigen Erweiterungsmethoden waren nicht veraltet.

Neues Verhalten

DatabaseErrorPageMiddleware und die zugehörigen Erweiterungsmethoden sind veraltet.

Grund für die Änderung

DatabaseErrorPageMiddleware wurde in eine erweiterbare API für die Seite mit Ausnahmen für Entwickler migriert. Weitere Informationen zur erweiterbaren API finden Sie im GitHub-Issue dotnet/aspnetcore#8536.

Führen Sie die folgenden Schritte aus:

  1. Verwenden Sie DatabaseErrorPageMiddleware nicht mehr in Ihrem Projekt. Entfernen Sie beispielsweise den Methodenaufruf UseDatabaseErrorPage aus Startup.Configure:

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDatabaseErrorPage();
    }
}

  2. Fügen Sie die Seite mit Ausnahmen für Entwickler zu Ihrem Projekt hinzu. Rufen Sie beispielsweise die Methode UseDeveloperExceptionPage in Startup.Configure auf:

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
}

  3. Fügen Sie das NuGet-Paket Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore zur Projektdatei hinzu.

  4. Fügen Sie den Datenbankfilter für die Seite mit Ausnahmen für Entwickler zu der Dienstsammlung hinzu. Rufen Sie beispielsweise die Methode AddDatabaseDeveloperPageExceptionFilter in Startup.ConfigureServices auf:

    public void ConfigureServices(IServiceCollection services)
{
    services.AddDatabaseDeveloperPageExceptionFilter();
}

Betroffene APIs