查看: 2148|回复: 0

[ASP.NET教程] 详解ASP.NET Core 中的多语言支持(Localization)

发表于 2018-1-3 08:00:01

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

  1. public void ConfigureServices(IServiceCollection services)
  2. {
  3. services.AddLocalization(options => options.ResourcesPath = "Resources");
  4. services.AddMvc()
  5. .AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix);
  6. services.Configure<RequestLocalizationOptions>(
  7. opts =>
  8. {
  9. var supportedCultures = new List<CultureInfo>
  10. {
  11. new CultureInfo("en-US"),
  12. new CultureInfo("zh-CN")
  13. };
  14. opts.SupportedCultures = supportedCultures;
  15. opts.SupportedUICultures = supportedCultures;
  16. });
  17. }
复制代码

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

  1. var requestLocalizationOptions = app.ApplicationServices.GetService<IOptions<RequestLocalizationOptions>>().Value;
  2. app.UseRequestLocalization(requestLocalizationOptions);
复制代码

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

  1. @using Microsoft.AspNetCore.Mvc.Localization
  2. @inject IViewLocalizer Localizer
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <title>@ViewData["Title"] - @Localizer["SiteTitle"]</title>
  7. </head>
  8. <body>
  9. </body>
  10. </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 站点,就会根据浏览器的语言设置(Accept-Language header)、或者 culture 查询参数、或者 .AspNetCore.Culture Cookie 值显示对应语言的文字:

需要注意的地方:千万不要添加不带语言名称的 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

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持程序员之家。



回复

使用道具 举报