体验 ASP.NET Core 中的多语言支持(Localization)

Posted dotNET跨平台

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了体验 ASP.NET Core 中的多语言支持(Localization)相关的知识,希望对你有一定的参考价值。

首先在 Startup 的 ConfigureServices 中添加 AddLocalization 与 AddViewLocalization 以及配置 RequestLocalizationOptions (这里假设使用英文与中文):

public void ConfigureServices(IServiceCollection services)

{

    services.AddLocalization(options => options.ResourcesPath = "Resources");


    services.AddMvc()

        .AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix);


    services.Configure<RequestLocalizationOptions>(

        opts =>

        {

            var supportedCultures = new List<CultureInfo>

            {

                new CultureInfo("en-US"),

                new CultureInfo("zh-CN")

            };

            opts.SupportedCultures = supportedCultures;

            opts.SupportedUICultures = supportedCultures;

        });

}

在 Startup 的 Configure() 方法中应用 RequestLocalizationOptions :

var requestLocalizationOptions = app.ApplicationServices.GetService<IOptions<RequestLocalizationOptions>>().Value;
app.UseRequestLocalization(requestLocalizationOptions);

然后在 _Layout.cshtml 视图中通过 IViewLocalizer 接口以多语言的方式显示页面标题的后缀:

@using Microsoft.AspNetCore.Mvc.Localization

@inject IViewLocalizer Localizer

<!DOCTYPE html>

<html>

<head>

    <title>@ViewData["Title"] - @Localizer["SiteTitle"]</title>

</head>

<body>

</body>

</html>

接着在 ASP.NET Core Web 项目中创建 Resources 文件夹,在其中分别添加 Views.Shared._Layout.en-Us.resx 与 Views.Shared._Layout.zh-CN.resx 文件, Views.Shared._Layout.resx 文件,并添加 "SiteTitle" 所对应的语句文字:

1)Views.Shared._Layout.en-Us.resx

2)Views.Shared._Layout.zh-CN.resx

体验 ASP.NET Core 中的多语言支持(Localization)

这时运行 ASP.NET Core 站点,就会根据浏览器的语言设置(Accept-Language header)、或者 culture 查询参数、或者 .AspNetCore.Culture Cookie 值显示对应语言的文字:

体验 ASP.NET Core 中的多语言支持(Localization)

需要注意的地方:千万不要添加不带语言名称的 Views.Shared._Layout.en-Us.resx ,不然添加代码语言名称的 .resx 文件时会遇到  "Custom tool ResXFileCodeGenerator failed to produce an output for input file ... but did not log a specific error." 问。

一定要看的参考文档:Globalization and localization 


.NET社区新闻,深度好文,微信中搜索dotNET跨平台或扫描二维码关注

以上是关于体验 ASP.NET Core 中的多语言支持(Localization)的主要内容,如果未能解决你的问题,请参考以下文章

ASP.Net Core Tag Helper 链接忽略当前文化

asp.net MVC 多语言设计

asp.net MVC 多语言设计

asp.net MVC 多语言设计

asp.net MVC 多语言设计

ASP.NET Core 6.0 本地化