Problembehandlung bei der ASP.NET Core-Lokalisierung

  • Artikel

Von Hisham Bin Ateya

Dieser Artikel enthält Anweisungen für die Diagnose von Problemen mit der Lokalisierung von ASP.NET Core-Apps.

Probleme bei der Lokalisierungskonfiguration

Reihenfolge der Lokalisierungsmiddleware
Die App kann möglicherweise nicht lokalisiert werden, da die Lokalisierungsmiddleware nicht in der erwarteten Reihenfolge angeordnet ist.

Um dieses Problem zu beheben, stellen Sie sicher, dass die Lokalisierungsmiddleware vor der MVC-Middleware registriert wurde. Andernfalls wird die Lokalisierungsmiddleware nicht angewendet.

public void ConfigureServices(IServiceCollection services)
{
    services.AddLocalization(options => options.ResourcesPath = "Resources");

    services.AddMvc();
}

Pfad der Lokalisierungsmiddleware nicht gefunden

Unterstützte Kulturen im RequestCultureProvider entsprechen nicht der einmaligen Registrierung

Probleme mit dem Ressourcendateinamen

ASP.NET Core verfügt über vordefinierte Regeln und Richtlinien für die Benennung von Lokalisierungsressourcendateien, die unter Globalisierung und Lokalisierung in ASP.NET Core beschrieben werden.

Fehlende Ressourcen

Häufige Ursachen, warum Ressourcen nicht gefundenen werden, sind:

  • Ressourcennamen wurden entweder in der .NET XML-Ressourcendatei (.resx) oder in der Lokalisierungsanforderung falsch geschrieben.
  • Die Ressource fehlt für einige Sprachen in der Ressourcendatei, ist für andere aber vorhanden.
  • Wenn weiterhin Probleme auftreten, überprüfen Sie die Protokollmeldungen der Lokalisierung (protokolliert auf der Debug-Protokollebene) auf weitere Informationen zu den fehlenden Ressourcen.

Tipp

Vergewissern Sie sich bei Verwendung von CookieRequestCultureProvider, dass für die Kulturen im Lokalisierungswert cookie keine einfachen Anführungszeichen verwendet werden. c='en-UK'|uic='en-US' ist beispielsweise ein ungültiger cookie-Wert, c=en-UK|uic=en-US hingegen ist gültig.

Probleme mit Ressourcen und Klassenbibliotheken

ASP.NET Core stellt standardmäßig eine Methode zur Verfügung, Klassenbibliotheken zu ermöglichen, ihre Ressourcendateien über ResourceLocationAttribute zu finden.

Folgende Probleme mit Klassenbibliotheken treten häufig auf:

CustomRequestCultureProvider funktioniert nicht wie erwartet.

Die RequestLocalizationOptions-Klasse verfügt über drei Standardanbieter:

Mit CustomRequestCultureProvider können Sie anpassen, wie die Lokalisierungskultur bereitgestellt wird. CustomRequestCultureProvider wird verwendet, wenn die Standardanbieter Ihren Anforderungen nicht entsprechen.

Ein häufiger Grund dafür, dass ein benutzerdefinierter Anbieter nicht ordnungsgemäß funktioniert, besteht darin, dass er nicht der erste Anbieter in der RequestCultureProviders-Liste ist. So beheben Sie dieses Problem:

  • Fügen Sie den benutzerdefinierten Anbieter an Position 0 in die RequestCultureProviders-Liste ein:

    options.AddInitialRequestCultureProvider(
    new CustomRequestCultureProvider(async context =>
    {
        // My custom request culture logic
        return new ProviderCultureResult("en");
    }));

  • Fügen Sie den benutzerdefinierten Anbieter an Position 0 in die RequestCultureProviders-Liste ein:

    options.RequestCultureProviders.Insert(0, 
    new CustomRequestCultureProvider(async context =>
    {
        // My custom request culture logic
        return new ProviderCultureResult("en");
    }));

Probleme mit dem Stammnamespace

Wenn der Stammnamespace einer Assembly sich vom Assemblynamen unterscheidet, funktioniert die Lokalisierung standardmäßig nicht. Um solche Probleme zu vermeiden, verwenden Sie das RootNamespace-Attribut, das unter Globalisierung und Lokalisierung in ASP.NET Core beschrieben wird.

Warnung

Ein Problem mit dem Stammnamespace kann auftreten, wenn der Name eines Projekts kein gültiger .NET-Bezeichner ist. Beispielsweise verwendet my-project-name.csproj den Stammnamespace „my_project_name“ und den Assemblynamen „my-project-name“, was zu diesem Fehler führt.

Ressourcen und Buildaktion

Wenn Sie Ressourcendateien für die Lokalisierung verwenden, ist es wichtig, dass sie über eine geeignete Buildaktion verfügen. Verwenden Sie Eingebettete Ressource. Andernfalls kann ResourceStringLocalizer diese Ressourcen nicht finden.

Standortüberschreibung mithilfe des Bereichs „Sensoren“ in den Entwicklertools

Wenn Sie die Standortüberschreibung mithilfe des Bereichs Sensoren in den Entwicklertools von Google Chrome oder Microsoft Edge verwenden, wird die Fallbacksprache nach dem Vorabrendering zurückgesetzt. Vermeiden Sie das Festlegen der Sprache mithilfe des Bereichs Sensoren beim Testen. Legen Sie die Sprache mithilfe der Spracheinstellungen des Browsers fest.

Weitere Informationen finden Sie unter Blazor-Lokalisierung funktioniert nicht mit InteractiveServer (dotnet/aspnetcore #53707).

GitHub-Issues mit hilfreichen Tipps zur Problemlösung