ASP.NET Core Blazor globalizace a lokalizace

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na true soubor projektu aplikace ( .csproj ):

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

Blazor Server aplikace jsou lokalizovány pomocí middleware lokalizace. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Program.cs:

builder.Services.AddLocalization();

Určete podporované jazykové verze aplikace Program.cs hned po přidání služby Routing middleware do kanálu zpracování. Následující příklad konfiguruje podporované jazykové verze pro USA Chilská English a španělština:

app.UseRequestLocalization(new RequestLocalizationOptions()
    .AddSupportedCultures(new[] { "en-US", "es-CL" })
    .AddSupportedUICultures(new[] { "en-US", "es-CL" }));

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Program.cs tématu ASP.NET Core Jiné .

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na true soubor projektu aplikace ( .csproj ):

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

Jazyková verze aplikace může být nastavena v JavaScriptu při Blazor spuštění s applicationCulture Blazor možností Start. Následující příklad nakonfiguruje aplikaci tak, aby se spouštěla pomocí USA en-US jazykové verze English ().

• V nástroji wwwroot/index.html Zabraňte Blazor automatickému spuštění autostart="false" přidáním Blazor značky k <script> :

  <script src="_framework/blazor.webassembly.js" autostart="false"></script>
  

• Přidejte následující <script> blok po Blazor <script> značce a před uzavírací </body> značku:

  <script>
    Blazor.start({
      applicationCulture: 'en-US'
    });
  </script>
  

Hodnota pro applicationCulture musí odpovídat formátu označení jazyka BCP-47. Další informace o Blazor spuštění najdete v tématu ASP.NET Core Blazor Úvod .

Alternativou k nastavení Blazor počáteční možnosti jazykové verze je nastavení jazykové verze v kódu jazyka C#. Nastavte CultureInfo.DefaultThreadCurrentCulture a CultureInfo.DefaultThreadCurrentUICulture v Program.cs .

Přidat System.Globalization obor názvů do Program.cs :

using System.Globalization;

Přidejte nastavení jazykové verze před řádek, který sestaví a spustí WebAssemblyHostBuilder ( await builder.Build().RunAsync(); ):

CultureInfo.DefaultThreadCurrentCulture = new CultureInfo("en-US");
CultureInfo.DefaultThreadCurrentUICulture = new CultureInfo("en-US");

Blazor Server aplikace jsou lokalizovány pomocí middleware lokalizace. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Program.cs:

builder.Services.AddLocalization();

Zadejte statickou jazykovou verzi Program.cs přímo po přidání middlewaru do kanálu zpracování. Následující příklad nakonfiguruje USA angličtinu:

app.UseRequestLocalization("en-US");

Hodnota jazykové verze pro UseRequestLocalization musí odpovídat formátu označení jazyka BCP-47.

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Program.cs tématu ASP.NET Core Jiné .

Příklady umístění, kam může aplikace ukládat předvolby uživatele, patří do místního úložiště prohlížeče (společné v Blazor WebAssembly aplikacích), v lokalizaci cookie nebo databázi (společné v Blazor Server aplikacích) nebo v externí službě připojené k externí databázi a k ní přistupované webovým rozhraním API. Následující příklad ukazuje, jak používat místní úložiště prohlížeče.

Přidejte odkaz na balíček pro Microsoft.Extensions.Localization balíček do souboru projektu aplikace ( .csproj ):

<PackageReference Include="Microsoft.Extensions.Localization" Version="{VERSION}" />

{VERSION}Zástupný symbol v předchozím odkazu na balíček je verze balíčku.

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na hodnotu true v souboru projektu:

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

Jazyková verze aplikace v Blazor WebAssembly aplikaci je nastavená pomocí Blazor rozhraní API rozhraní API. Výběr jazykové verze uživatele lze zachovat v místním úložišti prohlížeče.

V wwwroot/index.html souboru po Blazor <script> značce a před uzavírací </body> značkou poskytněte funkce js, aby získaly a nastavily výběr jazykové verze uživatele v místním úložišti prohlížeče:

<script>
  window.blazorCulture = {
    get: () => window.localStorage['BlazorCulture'],
    set: (value) => window.localStorage['BlazorCulture'] = value
  };
</script>

export function getBlazorCulture() {
  return window.localStorage['BlazorCulture'];
};
export function setBlazorCulture(value) {
  window.localStorage['BlazorCulture'] = value;
};

Přidejte obory názvů pro System.Globalization a Microsoft.JSInterop do horní části Program.cs :

using System.Globalization;
using Microsoft.JSInterop;

Odebrat následující řádek z Program.cs :

- await builder.Build().RunAsync();

Nahraďte předchozí řádek následujícím kódem. Kód přidá Blazor službu lokalizace do kolekce služeb aplikace s AddLocalization a pomocí zprostředkovatele komunikace js volá js a načte výběr jazykové verze uživatele z místního úložiště. Pokud místní úložiště neobsahuje jazykovou verzi pro uživatele, kód nastaví výchozí hodnotu USA English ( en-US ).

builder.Services.AddLocalization();

var host = builder.Build();

CultureInfo culture;
var js = host.Services.GetRequiredService<IJSRuntime>();
var result = await js.InvokeAsync<string>("blazorCulture.get");

if (result != null)
{
    culture = new CultureInfo(result);
}
else
{
    culture = new CultureInfo("en-US");
    await js.InvokeVoidAsync("blazorCulture.set", "en-US");
}

CultureInfo.DefaultThreadCurrentCulture = culture;
CultureInfo.DefaultThreadCurrentUICulture = culture;

await host.RunAsync();

Následující CultureSelector Komponenta ukazuje, jak nastavit výběr jazykové verze uživatele na místní úložiště prohlížeče přes interoperabilitu js. Komponenta je umístěna do Shared složky pro použití v rámci aplikace.

Shared/CultureSelector.razor:

@using  System.Globalization
@inject IJSRuntime JSRuntime
@inject NavigationManager Nav

<p>
    <label>
        Select your locale:
        <select @bind="Culture">
            @foreach (var culture in supportedCultures)
            {
                <option value="@culture">@culture.DisplayName</option>
            }
        </select>
    </label>
</p>

@code
{
    private CultureInfo[] supportedCultures = new[]
    {
        new CultureInfo("en-US"),
        new CultureInfo("es-CL"),
    };

    private CultureInfo Culture
    {
        get => CultureInfo.CurrentCulture;
        set
        {
            if (CultureInfo.CurrentCulture != value)
            {
                var js = (IJSInProcessRuntime)JSRuntime;
                js.InvokeVoid("blazorCulture.set", value.Name);

                Nav.NavigateTo(Nav.Uri, forceLoad: true);
            }
        }
    }
}

Uvnitř uzavírací </div> značky <div class="main"> elementu v Shared/MainLayout.razor přidejte CultureSelector komponentu:

<div class="bottom-row px-4">
    <CultureSelector />
</div>

Příklady umístění, kam může aplikace ukládat předvolby uživatele, patří do místního úložiště prohlížeče (společné v Blazor WebAssembly aplikacích), v lokalizaci cookie nebo databázi (společné v Blazor Server aplikacích) nebo v externí službě připojené k externí databázi a k ní přistupované webovým rozhraním API. Následující příklad ukazuje, jak použít lokalizaci cookie .

Přidejte odkaz na balíček pro Microsoft.Extensions.Localization balíček do souboru projektu aplikace ( .csproj ):

<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.Localization" Version="{VERSION}" />
</ItemGroup>

{VERSION}Zástupný symbol v předchozím odkazu na balíček je verze balíčku.

Blazor Server aplikace jsou lokalizovány pomocí middleware lokalizace. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Program.cs:

builder.Services.AddLocalization();

Nastavte výchozí a podporované jazykové verze aplikace pomocí RequestLocalizationOptions.SetDefaultCulture .

Program.csIhned po přidání middlewaru do kanálu zpracování:

var supportedCultures = new[] { "en-US", "es-CL" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Program.cs tématu ASP.NET Core Jiné .

Následující příklad ukazuje, jak nastavit aktuální jazykovou verzi v cookie , kterou lze přečíst pomocí middleware Localization.

Do horní části souboru přidejte následující obory názvů Pages/_Layout.cshtml :

@using System.Globalization
@using Microsoft.AspNetCore.Localization

Hned za úvodní <body> značku Pages/_Layout.cshtml přidejte následující Razor výraz:

@{
    this.HttpContext.Response.Cookies.Append(
        CookieRequestCultureProvider.DefaultCookieName,
        CookieRequestCultureProvider.MakeCookieValue(
            new RequestCulture(
                CultureInfo.CurrentCulture,
                CultureInfo.CurrentUICulture)));
}

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Program.cs tématu ASP.NET Core Jiné .

Pokud aplikace není nakonfigurovaná na zpracování akcí kontroleru:

• Přidat MVC Services voláním AddControllers na kolekci služeb v Program.cs :

  builder.Services.AddControllers();
  

• Přidejte směrování koncových bodů řadiče do služby Program.cs voláním MapControllers IEndpointRouteBuilder :

  app.MapControllers();
  

  Následující příklad ukazuje volání UseEndpoints po přidání řádku:

  app.MapControllers();
  app.MapBlazorHub();
  app.MapFallbackToPage("/_Host");
  

Chcete-li poskytnout uživatelské rozhraní, které uživateli umožní vybrat jazykovou verzi, použijte k lokalizaci přístup založený na přesměrování cookie . Aplikace zachovává vybranou jazykovou verzi uživatele prostřednictvím přesměrování na kontroler. Řadič Nastaví vybranou jazykovou verzi uživatele na cookie a přesměruje uživatele zpět na původní identifikátor URI. Proces se podobá tomu, co se stane ve webové aplikaci, když se uživatel pokusí o přístup k zabezpečenému prostředku, kde je uživatel přesměrován na přihlašovací stránku a pak se přesměruje zpátky na původní prostředek.

Controllers/CultureController.cs:

using Microsoft.AspNetCore.Localization;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]/[action]")]
public class CultureController : Controller
{
    public IActionResult Set(string culture, string redirectUri)
    {
        if (culture != null)
        {
            HttpContext.Response.Cookies.Append(
                CookieRequestCultureProvider.DefaultCookieName,
                CookieRequestCultureProvider.MakeCookieValue(
                    new RequestCulture(culture, culture)));
        }

        return LocalRedirect(redirectUri);
    }
}

Následující CultureSelector Komponenta ukazuje, jak provést počáteční přesměrování, když uživatel vybere jazykovou verzi. Komponenta je umístěna do Shared složky pro použití v rámci aplikace.

Shared/CultureSelector.razor:

@using  System.Globalization
@inject NavigationManager Nav

<p>
    <label>
        Select your locale:
        <select @bind="Culture">
            @foreach (var culture in supportedCultures)
            {
                <option value="@culture">@culture.DisplayName</option>
            }
        </select>
    </label>
</p>

@code
{
    private CultureInfo[] supportedCultures = new[]
    {
        new CultureInfo("en-US"),
        new CultureInfo("es-CL"),
    };

    protected override void OnInitialized()
    {
        Culture = CultureInfo.CurrentCulture;
    }

    private CultureInfo Culture
    {
        get => CultureInfo.CurrentCulture;
        set
        {
            if (CultureInfo.CurrentCulture != value)
            {
                var uri = new Uri(Nav.Uri)
                    .GetComponents(UriComponents.PathAndQuery, UriFormat.Unescaped);
                var cultureEscaped = Uri.EscapeDataString(value.Name);
                var uriEscaped = Uri.EscapeDataString(uri);

                Nav.NavigateTo(
                    $"Culture/Set?culture={cultureEscaped}&redirectUri={uriEscaped}",
                    forceLoad: true);
            }
        }
    }
}

Uvnitř uzavírací </div> značky <div class="main"> elementu v Shared/MainLayout.razor přidejte CultureSelector komponentu:

<div class="bottom-row px-4">
    <CultureSelector />
</div>

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na true soubor projektu aplikace ( .csproj ):

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

V nástroji Program.cs přidejte obor názvů do System.Globalization horní části souboru:

using System.Globalization;

BlazorSlužba lokalizace se přidá do kolekce služeb aplikace s nástrojem AddLocalization v Program.cs :

builder.Services.AddLocalization();

K nastavení jazykové verze aplikace použijte middleware lokalizace .

Pokud aplikace ještě nepodporuje výběr jazykové verze v části dynamicky nastavovat jazyk podle preferencí uživatele v tomto článku:

• Přidejte do aplikace lokalizační služby pomocí AddLocalization .
• Zadejte výchozí a podporované jazykové verze aplikace v Program.cs . Následující příklad konfiguruje podporované jazykové verze pro USA English a Chilská španělština.

V Program.cs:

builder.Services.AddLocalization();

Program.csIhned po přidání middlewaru do kanálu zpracování:

var supportedCultures = new[] { "en-US", "es-CL" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Program.cs tématu ASP.NET Core Jiné .

Pokud by aplikace měla lokalizovat prostředky na základě ukládání nastavení jazykové verze uživatele, použijte lokalizaci kultury cookie . Použití nástroje cookie zajistí, že připojení protokolu WebSocket dokáže správně rozšířit jazykovou verzi. Pokud jsou schémata lokalizací založena na cestě URL nebo řetězci dotazu, nemusí být schopná pracovat s objekty WebSockets, takže nepůjde zachovat jazykovou verzi. Proto je doporučený přístup použít lokalizovanou jazykovou verzi cookie . V části dynamické nastavení jazykové verze podle předvoleb uživatele v tomto článku se zobrazí vzorový Razor výraz pro Pages/_Layout.cshtml soubor, který uchovává výběr jazykové verze uživatele.

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na v souboru projektu aplikace ( true .csproj ):

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

Blazor Server Aplikace jsou lokalizované pomocí lokalizačního middlewaru. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Startup.ConfigureServices souboru ( Startup.cs ):

services.AddLocalization();

Určete podporované jazykové verze aplikace v ( ) ihned po přidání middlewaru směrování Startup.Configure Startup.cs do kanálu zpracování. Následující příklad konfiguruje podporované jazykové verze pro jazykovou USA angličtině a španělštině:

app.UseRequestLocalization(new RequestLocalizationOptions()
    .AddSupportedCultures(new[] { "en-US", "es-CL" })
    .AddSupportedUICultures(new[] { "en-US", "es-CL" }));

Informace o objednání middlewaru lokalizace v middlewaru kanálu najdete Startup.Configure v tématu ASP.NET Core Jiné .

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na v souboru projektu aplikace ( true .csproj ):

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

Jazykovou verzi aplikace je možné nastavit v JavaScriptu, Blazor když začíná applicationCulture Blazor možností start. Následující příklad nakonfiguruje aplikaci tak, aby se spouštěl pomocí USA jazykové verze angličtiny ( en-US ).

• V wwwroot/index.html Blazor zabraňte automatickému spuštění autostart="false" Blazor přidáním do <script> značky ' :

  <script src="_framework/blazor.webassembly.js" autostart="false"></script>
  

• Přidejte následující <script> blok za značku a před uzavírací Blazor <script> </body> značku:

  <script>
    Blazor.start({
      applicationCulture: 'en-US'
    });
  </script>
  

Hodnota pro musí odpovídat formátu značky jazyka applicationCulture BCP-47. Další informace o spuštění Blazor najdete v tématu ASP.NET Core Blazor Úvod .

Alternativou k nastavení možnosti start jazykové verze je nastavení Blazor jazykové verze v kódu jazyka C#. Nastavte CultureInfo.DefaultThreadCurrentCulture a CultureInfo.DefaultThreadCurrentUICulture v Program.cs .

Přidejte System.Globalization obor názvů do Program.cs :

using System.Globalization;

Přidejte nastavení jazykové verze před řádek, který sestaví a spustí WebAssemblyHostBuilder ( await builder.Build().RunAsync(); ):

CultureInfo.DefaultThreadCurrentCulture = new CultureInfo("en-US");
CultureInfo.DefaultThreadCurrentUICulture = new CultureInfo("en-US");

Blazor Server Aplikace jsou lokalizované pomocí lokalizačního middlewaru. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Startup.ConfigureServices souboru ( Startup.cs ):

services.AddLocalization();

Zadejte statickou jazykovou verzi v souboru ( ) ihned po přidání middlewaru směrování Startup.Configure Startup.cs do kanálu zpracování. Následující příklad konfiguruje USA angličtině:

app.UseRequestLocalization("en-US");

Hodnota jazykové verze pro musí odpovídat formátu značky jazyka UseRequestLocalization BCP-47.

Informace o objednání middlewaru lokalizace v middlewaru kanálu najdete Startup.Configure v tématu ASP.NET Core Jiné .

Mezi příklady umístění, kam může aplikace ukládat předvolby uživatele, patří místní úložiště prohlížeče (běžné v aplikacích), lokalizace nebo databáze (v aplikacích Blazor WebAssembly běžné) nebo v externí službě připojené k externí databázi, ke které přistupuje webové cookie rozhraní Blazor Server API. Následující příklad ukazuje, jak používat místní úložiště prohlížeče.

Přidejte odkaz na Microsoft.Extensions.Localization balíček pro balíček do souboru projektu aplikace ( .csproj ):

<PackageReference Include="Microsoft.Extensions.Localization" Version="{VERSION}" />

Zástupný {VERSION} symbol v předchozím odkazu na balíček je verze balíčku.

V souboru BlazorWebAssemblyLoadAllGlobalizationData projektu true nastavte vlastnost na :

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

Jazyková verze aplikace se v Blazor WebAssembly aplikaci nastaví pomocí Blazor rozhraní API architektury. Výběr jazykové verze uživatele lze zachovat v místním úložišti prohlížeče.

V souboru za značkou a před uzavírací značkou zadejte funkce JS pro získání a nastavení výběru jazykové verze uživatele pomocí wwwroot/index.html Blazor místního úložiště <script> </body> prohlížeče:

<script>
  window.blazorCulture = {
    get: () => window.localStorage['BlazorCulture'],
    set: (value) => window.localStorage['BlazorCulture'] = value
  };
</script>

export function getBlazorCulture() {
  return window.localStorage['BlazorCulture'];
};
export function setBlazorCulture(value) {
  window.localStorage['BlazorCulture'] = value;
};

Přidejte obory názvů pro System.Globalization a Microsoft.JSInterop do horní části Program.cs :

using System.Globalization;
using Microsoft.JSInterop;

Odebrat následující řádek z Program.cs :

- await builder.Build().RunAsync();

Nahraďte předchozí řádek následujícím kódem. Kód přidá Blazor službu lokalizace do kolekce služeb aplikace s AddLocalization a pomocí zprostředkovatele komunikace js volá js a načte výběr jazykové verze uživatele z místního úložiště. Pokud místní úložiště neobsahuje jazykovou verzi pro uživatele, kód nastaví výchozí hodnotu USA English ( en-US ).

builder.Services.AddLocalization();

var host = builder.Build();

CultureInfo culture;
var js = host.Services.GetRequiredService<IJSRuntime>();
var result = await js.InvokeAsync<string>("blazorCulture.get");

if (result != null)
{
    culture = new CultureInfo(result);
}
else
{
    culture = new CultureInfo("en-US");
    await js.InvokeVoidAsync("blazorCulture.set", "en-US");
}

CultureInfo.DefaultThreadCurrentCulture = culture;
CultureInfo.DefaultThreadCurrentUICulture = culture;

await host.RunAsync();

Následující CultureSelector Komponenta ukazuje, jak nastavit výběr jazykové verze uživatele na místní úložiště prohlížeče přes interoperabilitu js. Komponenta je umístěna do Shared složky pro použití v rámci aplikace.

Shared/CultureSelector.razor:

@using  System.Globalization
@inject IJSRuntime JSRuntime
@inject NavigationManager Nav

<p>
    <label>
        Select your locale:
        <select @bind="Culture">
            @foreach (var culture in supportedCultures)
            {
                <option value="@culture">@culture.DisplayName</option>
            }
        </select>
    </label>
</p>

@code
{
    private CultureInfo[] supportedCultures = new[]
    {
        new CultureInfo("en-US"),
        new CultureInfo("es-CL"),
    };

    private CultureInfo Culture
    {
        get => CultureInfo.CurrentCulture;
        set
        {
            if (CultureInfo.CurrentCulture != value)
            {
                var js = (IJSInProcessRuntime)JSRuntime;
                js.InvokeVoid("blazorCulture.set", value.Name);

                Nav.NavigateTo(Nav.Uri, forceLoad: true);
            }
        }
    }
}

Uvnitř uzavírací </div> značky <div class="main"> elementu v Shared/MainLayout.razor přidejte CultureSelector komponentu:

<div class="bottom-row px-4">
    <CultureSelector />
</div>

Příklady umístění, kam může aplikace ukládat předvolby uživatele, patří do místního úložiště prohlížeče (společné v Blazor WebAssembly aplikacích), v lokalizaci cookie nebo databázi (společné v Blazor Server aplikacích) nebo v externí službě připojené k externí databázi a k ní přistupované webovým rozhraním API. Následující příklad ukazuje, jak použít lokalizaci cookie .

Přidejte odkaz na balíček pro Microsoft.Extensions.Localization balíček do souboru projektu aplikace ( .csproj ):

<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.Localization" Version="{VERSION}" />
</ItemGroup>

{VERSION}Zástupný symbol v předchozím odkazu na balíček je verze balíčku.

Blazor Server aplikace jsou lokalizovány pomocí middleware lokalizace. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Startup.ConfigureServices ( Startup.cs ):

services.AddLocalization();

Nastavte výchozí a podporované jazykové verze aplikace pomocí RequestLocalizationOptions.SetDefaultCulture .

Startup.ConfigureIhned po přidání middlewaru do kanálu zpracování:

var supportedCultures = new[] { "en-US", "es-CL" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Startup.Configure tématu ASP.NET Core Jiné .

Následující příklad ukazuje, jak nastavit aktuální jazykovou verzi v cookie , kterou lze přečíst pomocí middleware Localization.

Do horní části souboru přidejte následující obory názvů Pages/_Host.cshtml :

@using System.Globalization
@using Microsoft.AspNetCore.Localization

Hned za úvodní <body> značku Pages/_Host.cshtml přidejte následující Razor výraz:

@{
    this.HttpContext.Response.Cookies.Append(
        CookieRequestCultureProvider.DefaultCookieName,
        CookieRequestCultureProvider.MakeCookieValue(
            new RequestCulture(
                CultureInfo.CurrentCulture,
                CultureInfo.CurrentUICulture)));
}

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Startup.Configure tématu ASP.NET Core Jiné .

Pokud aplikace není nakonfigurovaná na zpracování akcí kontroleru:

• Přidat MVC Services voláním AddControllers na kolekci služeb v Startup.ConfigureServices :

  services.AddControllers();
  

• Přidejte směrování koncových bodů řadiče do služby Startup.Configure voláním MapControllers IEndpointRouteBuilder :

  endpoints.MapControllers();
  

  Následující příklad ukazuje volání UseEndpoints po přidání řádku:

  app.UseEndpoints(endpoints =>
  {
  +   endpoints.MapControllers();
      endpoints.MapBlazorHub();
      endpoints.MapFallbackToPage("/_Host");
  });
  

Chcete-li poskytnout uživatelské rozhraní, které uživateli umožní vybrat jazykovou verzi, použijte k lokalizaci přístup založený na přesměrování cookie . Aplikace zachovává vybranou jazykovou verzi uživatele prostřednictvím přesměrování na kontroler. Řadič Nastaví vybranou jazykovou verzi uživatele na cookie a přesměruje uživatele zpět na původní identifikátor URI. Proces se podobá tomu, co se stane ve webové aplikaci, když se uživatel pokusí o přístup k zabezpečenému prostředku, kde je uživatel přesměrován na přihlašovací stránku a pak se přesměruje zpátky na původní prostředek.

Controllers/CultureController.cs:

using Microsoft.AspNetCore.Localization;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]/[action]")]
public class CultureController : Controller
{
    public IActionResult Set(string culture, string redirectUri)
    {
        if (culture != null)
        {
            HttpContext.Response.Cookies.Append(
                CookieRequestCultureProvider.DefaultCookieName,
                CookieRequestCultureProvider.MakeCookieValue(
                    new RequestCulture(culture, culture)));
        }

        return LocalRedirect(redirectUri);
    }
}

Následující CultureSelector Komponenta ukazuje, jak provést počáteční přesměrování, když uživatel vybere jazykovou verzi. Komponenta je umístěna do Shared složky pro použití v rámci aplikace.

Shared/CultureSelector.razor:

@using  System.Globalization
@inject NavigationManager Nav

<p>
    <label>
        Select your locale:
        <select @bind="Culture">
            @foreach (var culture in supportedCultures)
            {
                <option value="@culture">@culture.DisplayName</option>
            }
        </select>
    </label>
</p>

@code
{
    private CultureInfo[] supportedCultures = new[]
    {
        new CultureInfo("en-US"),
        new CultureInfo("es-CL"),
    };

    protected override void OnInitialized()
    {
        Culture = CultureInfo.CurrentCulture;
    }

    private CultureInfo Culture
    {
        get => CultureInfo.CurrentCulture;
        set
        {
            if (CultureInfo.CurrentCulture != value)
            {
                var uri = new Uri(Nav.Uri)
                    .GetComponents(UriComponents.PathAndQuery, UriFormat.Unescaped);
                var cultureEscaped = Uri.EscapeDataString(value.Name);
                var uriEscaped = Uri.EscapeDataString(uri);

                Nav.NavigateTo(
                    $"Culture/Set?culture={cultureEscaped}&redirectUri={uriEscaped}",
                    forceLoad: true);
            }
        }
    }
}

Uvnitř uzavírací </div> značky <div class="main"> elementu v Shared/MainLayout.razor přidejte CultureSelector komponentu:

<div class="bottom-row px-4">
    <CultureSelector />
</div>

Nastavte BlazorWebAssemblyLoadAllGlobalizationData vlastnost na true soubor projektu aplikace ( .csproj ):

<PropertyGroup>
  <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
</PropertyGroup>

V nástroji Program.cs přidejte obor názvů do System.Globalization horní části souboru:

using System.Globalization;

BlazorSlužba lokalizace se přidá do kolekce služeb aplikace s nástrojem AddLocalization v Program.cs :

builder.Services.AddLocalization();

K nastavení jazykové verze aplikace použijte middleware lokalizace .

Pokud aplikace ještě nepodporuje výběr jazykové verze v části dynamicky nastavovat jazyk podle preferencí uživatele v tomto článku:

• Přidejte do aplikace lokalizační služby pomocí AddLocalization .
• Zadejte výchozí a podporované jazykové verze aplikace v Startup.Configure ( Startup.cs ). Následující příklad konfiguruje podporované jazykové verze pro USA English a Chilská španělština.

V Startup.ConfigureServices ( Startup.cs ):

services.AddLocalization();

Startup.ConfigureIhned po přidání middlewaru do kanálu zpracování:

var supportedCultures = new[] { "en-US", "es-CL" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Startup.Configure tématu ASP.NET Core Jiné .

Pokud by aplikace měla lokalizovat prostředky na základě ukládání nastavení jazykové verze uživatele, použijte lokalizaci kultury cookie . Použití nástroje cookie zajistí, že připojení protokolu WebSocket dokáže správně rozšířit jazykovou verzi. Pokud jsou schémata lokalizací založena na cestě URL nebo řetězci dotazu, nemusí být schopná pracovat s objekty WebSockets, takže nepůjde zachovat jazykovou verzi. Proto je doporučený přístup použít lokalizovanou jazykovou verzi cookie . V části dynamické nastavení jazykové verze podle předvoleb uživatele v tomto článku se zobrazí vzorový Razor výraz pro Pages/_Host.cshtml soubor, který uchovává výběr jazykové verze uživatele.

Blazor Server Aplikace jsou lokalizované pomocí lokalizačního middlewaru. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Startup.ConfigureServices souboru ( Startup.cs ):

services.AddLocalization();

Určete podporované jazykové verze aplikace v ( ) ihned po přidání middlewaru směrování Startup.Configure Startup.cs do kanálu zpracování. Následující příklad konfiguruje podporované jazykové verze pro jazykovou USA angličtinu a španělštinu:

app.UseRequestLocalization(new RequestLocalizationOptions()
    .AddSupportedCultures(new[] { "en-US", "es-CL" })
    .AddSupportedUICultures(new[] { "en-US", "es-CL" }));

Informace o objednání middlewaru lokalizace v middlewaru kanálu najdete Startup.Configure v tématu ASP.NET Core Jiné .

Konfigurace linkeru IL (Intermediate Language) pro aplikace ve výchozím nastavení odčítá informace o globalizaci s výjimkou explicitně Blazor WebAssembly požadovaných národního prostředí. Další informace naleznete v tématu Konfigurace linkeru pro ASP.NET Core Blazor.

Blazor Server Aplikace jsou lokalizované pomocí lokalizačního middlewaru. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Startup.ConfigureServices souboru ( Startup.cs ):

services.AddLocalization();

Zadejte statickou jazykovou verzi v souboru ( ) ihned po přidání middlewaru směrování Startup.Configure Startup.cs do kanálu zpracování. Následující příklad konfiguruje USA angličtině:

app.UseRequestLocalization("en-US");

Hodnota jazykové verze pro musí odpovídat formátu značky jazyka UseRequestLocalization BCP-47.

Informace o objednání middlewaru lokalizace v middlewaru kanálu najdete Startup.Configure v tématu ASP.NET Core Jiné .

Mezi příklady umístění, kam může aplikace ukládat předvolby uživatele, patří místní úložiště prohlížeče (v aplikacích běžné), lokalizace nebo databáze (v aplikacích Blazor WebAssembly běžné) nebo v externí službě připojené k externí databázi, ke které přistupuje webové cookie rozhraní Blazor Server API. Následující příklad ukazuje, jak používat místní úložiště prohlížeče.

Přidejte odkaz na Microsoft.Extensions.Localization balíček pro balíček do souboru projektu aplikace ( .csproj ):

<PackageReference Include="Microsoft.Extensions.Localization" Version="{VERSION}" />

Zástupný {VERSION} symbol v předchozím odkazu na balíček je verze balíčku.

Jazyková verze aplikace se v Blazor WebAssembly aplikaci nastaví pomocí Blazor rozhraní API architektury. Výběr jazykové verze uživatele lze zachovat v místním úložišti prohlížeče.

V souboru za značkou a před uzavírací značkou zadejte funkce JS pro získání a nastavení výběru jazykové verze uživatele pomocí wwwroot/index.html Blazor místního úložiště <script> </body> prohlížeče:

<script>
  window.blazorCulture = {
    get: () => window.localStorage['BlazorCulture'],
    set: (value) => window.localStorage['BlazorCulture'] = value
  };
</script>

Přidejte obory názvů System.Globalization pro a na začátek Microsoft.JSInterop Program.cs :

using System.Globalization;
using Microsoft.JSInterop;

Odeberte následující řádek z Program.cs :

-await builder.Build().RunAsync();

Nahraďte předchozí řádek následujícím kódem. Kód přidá službu lokalizace do kolekce služby aplikace pomocí a používá interoperabilitu JS k volání do JS a načtení výběru jazykové verze Blazor AddLocalization uživatele z místního úložiště. Pokud místní úložiště neobsahuje jazykovou verzi pro uživatele, kód nastaví výchozí hodnotu pro USA angličtině ( en-US ).

builder.Services.AddLocalization();

var host = builder.Build();

CultureInfo culture;
var js = host.Services.GetRequiredService<IJSRuntime>();
var result = await js.InvokeAsync<string>("blazorCulture.get");

if (result != null)
{
    culture = new CultureInfo(result);
}
else
{
    culture = new CultureInfo("en-US");
    await js.InvokeVoidAsync("blazorCulture.set", "en-US");
}

CultureInfo.DefaultThreadCurrentCulture = culture;
CultureInfo.DefaultThreadCurrentUICulture = culture;

await host.RunAsync();

Následující komponenta ukazuje, jak nastavit výběr jazykové verze uživatele do místního úložiště prohlížeče CultureSelector prostřednictvím zprostředkovatele komunikace JS. Komponenta se umístí do Shared složky pro použití v celé aplikaci.

Shared/CultureSelector.razor:

@using  System.Globalization
@inject IJSRuntime JSRuntime
@inject NavigationManager Nav

<p>
    <label>
        Select your locale:
        <select @bind="Culture">
            @foreach (var culture in supportedCultures)
            {
                <option value="@culture">@culture.DisplayName</option>
            }
        </select>
    </label>
</p>

@code
{
    private CultureInfo[] supportedCultures = new[]
    {
        new CultureInfo("en-US"),
        new CultureInfo("es-CL"),
    };

    private CultureInfo Culture
    {
        get => CultureInfo.CurrentCulture;
        set
        {
            if (CultureInfo.CurrentCulture != value)
            {
                var js = (IJSInProcessRuntime)JSRuntime;
                js.InvokeVoid("blazorCulture.set", value.Name);

                Nav.NavigateTo(Nav.Uri, forceLoad: true);
            }
        }
    }
}

Do uzavírací </div> značky <div class="main"> elementu v Shared/MainLayout.razor souboru přidejte CultureSelector komponentu :

<div class="bottom-row px-4">
    <CultureSelector />
</div>

Mezi příklady umístění, kam může aplikace ukládat předvolby uživatele, patří místní úložiště prohlížeče (v aplikacích běžné), lokalizace nebo databáze (v aplikacích Blazor WebAssembly běžné) nebo v externí službě připojené k externí databázi, ke které přistupuje webové cookie rozhraní Blazor Server API. Následující příklad ukazuje, jak použít lokalizaci cookie .

Přidejte odkaz na Microsoft.Extensions.Localization balíček pro balíček do souboru projektu aplikace ( .csproj ):

<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.Localization" Version="{VERSION}" />
</ItemGroup>

Zástupný {VERSION} symbol v předchozím odkazu na balíček je verze balíčku.

Blazor Server Aplikace jsou lokalizované pomocí lokalizačního middlewaru. Přidejte do aplikace lokalizační služby pomocí AddLocalization .

V Startup.ConfigureServices souboru ( Startup.cs ):

services.AddLocalization();

Nastavte výchozí a podporované jazykové verze aplikace pomocí RequestLocalizationOptions.SetDefaultCulture .

Okamžitě Startup.Configure po přidání middlewaru směrování do kanálu zpracování:

var supportedCultures = new[] { "en-US", "es-CL" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

Informace o objednání middlewaru lokalizace v middlewaru kanálu najdete Startup.Configure v tématu ASP.NET Core Jiné .

Následující příklad ukazuje, jak nastavit aktuální jazykovou verzi v , cookie kterou lze číst middlewarem pro lokalizaci.

Na začátek souboru přidejte následující Pages/_Host.cshtml obory názvů:

@using System.Globalization
@using Microsoft.AspNetCore.Localization

Ihned za úvodní <body> značku Pages/_Host.cshtml souboru přidejte následující Razor výraz:

@{
    this.HttpContext.Response.Cookies.Append(
        CookieRequestCultureProvider.DefaultCookieName,
        CookieRequestCultureProvider.MakeCookieValue(
            new RequestCulture(
                CultureInfo.CurrentCulture,
                CultureInfo.CurrentUICulture)));
}

Informace o objednání middlewaru lokalizace v middlewaru kanálu najdete Startup.Configure v tématu ASP.NET Core Jiné .

Pokud aplikace není nakonfigurovaná ke zpracování akcí kontroleru:

• Přidejte služby MVC AddControllers voláním v kolekci služby v Startup.ConfigureServices :

  services.AddControllers();
  

• Přidejte směrování koncového bodu Startup.Configure kontroleru do MapControllers voláním v IEndpointRouteBuilder :

  endpoints.MapControllers();
  

  Následující příklad ukazuje volání po UseEndpoints přidání řádku:

  app.UseEndpoints(endpoints =>
  {
  +   endpoints.MapControllers();
      endpoints.MapBlazorHub();
      endpoints.MapFallbackToPage("/_Host");
  });
  

Pokud chcete poskytnout uživatelské rozhraní, které uživateli umožní vybrat jazykovou verzi, použijte u lokalizace přístup založený na cookie přesměrování. Aplikace zachovává vybranou jazykovou verzi uživatele prostřednictvím přesměrování na kontroler. Řadič Nastaví vybranou jazykovou verzi uživatele na cookie a přesměruje uživatele zpět na původní identifikátor URI. Proces se podobá tomu, co se stane ve webové aplikaci, když se uživatel pokusí o přístup k zabezpečenému prostředku, kde je uživatel přesměrován na přihlašovací stránku a pak se přesměruje zpátky na původní prostředek.

Controllers/CultureController.cs:

using Microsoft.AspNetCore.Localization;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]/[action]")]
public class CultureController : Controller
{
    public IActionResult Set(string culture, string redirectUri)
    {
        if (culture != null)
        {
            HttpContext.Response.Cookies.Append(
                CookieRequestCultureProvider.DefaultCookieName,
                CookieRequestCultureProvider.MakeCookieValue(
                    new RequestCulture(culture, culture)));
        }

        return LocalRedirect(redirectUri);
    }
}

Následující CultureSelector Komponenta ukazuje, jak provést počáteční přesměrování, když uživatel vybere jazykovou verzi. Komponenta je umístěna do Shared složky pro použití v rámci aplikace.

Shared/CultureSelector.razor:

@using  System.Globalization
@inject NavigationManager Nav

<p>
    <label>
        Select your locale:
        <select @bind="Culture">
            @foreach (var culture in supportedCultures)
            {
                <option value="@culture">@culture.DisplayName</option>
            }
        </select>
    </label>
</p>

@code
{
    private CultureInfo[] supportedCultures = new[]
    {
        new CultureInfo("en-US"),
        new CultureInfo("es-CL"),
    };

    protected override void OnInitialized()
    {
        Culture = CultureInfo.CurrentCulture;
    }

    private CultureInfo Culture
    {
        get => CultureInfo.CurrentCulture;
        set
        {
            if (CultureInfo.CurrentCulture != value)
            {
                var uri = new Uri(Nav.Uri)
                    .GetComponents(UriComponents.PathAndQuery, UriFormat.Unescaped);
                var cultureEscaped = Uri.EscapeDataString(value.Name);
                var uriEscaped = Uri.EscapeDataString(uri);

                Nav.NavigateTo(
                    $"Culture/Set?culture={cultureEscaped}&redirectUri={uriEscaped}",
                    forceLoad: true);
            }
        }
    }
}

Uvnitř uzavírací </div> značky <div class="main"> elementu v Shared/MainLayout.razor přidejte CultureSelector komponentu:

<div class="bottom-row px-4">
    <CultureSelector />
</div>

Ve výchozím nastavení konfigurace linkeru pro Blazor WebAssembly aplikace vyřadí informace o mezinárodním prostředí, s výjimkou výslovně požadovaných místních hodnot. Další informace naleznete v tématu Konfigurace linkeru pro ASP.NET Core Blazor.

V nástroji Program.cs přidejte obor názvů do System.Globalization horní části souboru:

using System.Globalization;

BlazorSlužba lokalizace se přidá do kolekce služeb aplikace s nástrojem AddLocalization v Program.cs :

builder.Services.AddLocalization();

K nastavení jazykové verze aplikace použijte middleware lokalizace .

Pokud aplikace ještě nepodporuje výběr jazykové verze v části dynamicky nastavovat jazyk podle preferencí uživatele v tomto článku:

• Přidejte do aplikace lokalizační služby pomocí AddLocalization .
• Zadejte výchozí a podporované jazykové verze aplikace v Startup.Configure ( Startup.cs ). Následující příklad konfiguruje podporované jazykové verze pro USA English a Chilská španělština.

V Startup.ConfigureServices ( Startup.cs ):

services.AddLocalization();

Startup.ConfigureIhned po přidání middlewaru do kanálu zpracování:

var supportedCultures = new[] { "en-US", "es-CL" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

Informace o řazení middlewaru pro lokalizaci v kanálu middlewaru pro najdete v Startup.Configure tématu ASP.NET Core Jiné .

Pokud by aplikace měla lokalizovat prostředky na základě ukládání nastavení jazykové verze uživatele, použijte lokalizaci kultury cookie . Použití nástroje cookie zajistí, že připojení protokolu WebSocket dokáže správně rozšířit jazykovou verzi. Pokud jsou schémata lokalizací založena na cestě URL nebo řetězci dotazu, nemusí být schopná pracovat s objekty WebSockets, takže nepůjde zachovat jazykovou verzi. Proto je doporučený přístup použít lokalizovanou jazykovou verzi cookie . V části dynamické nastavení jazykové verze podle předvoleb uživatele v tomto článku se zobrazí vzorový Razor výraz pro Pages/_Host.cshtml soubor, který uchovává výběr jazykové verze uživatele.