一文教会你.Net之多语言配置

本文转载自微信公众号「鹏祥」，文教作者AZRNG。配置转载本文请联系鹏祥公众号。文教

开篇语

首先非常感谢各位朋友或技术爱好者的配置关注。

介绍

支持多语言使网站可以覆盖更广泛的文教受众。ASP.NET Core 提供的配置服务和中间件可将网站本地化为不同的语言。

本次示例环境：vs2019、文教net5

配置

无需引用Nuget包即可实现以下功能。配置

注入容器

services.AddLocalization(t => {      t.ResourcesPath = "Language"; }); 

启用配置

var supportedCultures = new List<CultureInfo>() {      new CultureInfo("zh-CN"),文教     new CultureInfo("en-US") }; app.UseRequestLocalization(new RequestLocalizationOptions {      //这里指定默认语言包     DefaultRequestCulture = new RequestCulture("en-US"),//为了测试配置默认语言英文     SupportedCultures = supportedCultures,     SupportedUICultures = supportedCultures }); 

语言配置文件

需要在根目录新建一个文件夹，文件夹名字就是源码库配置ResourcesPath的名字。资源文件(resx结尾)存放路径需要和使用的文教地方目录结构一致。(右键文件夹>添加>新建项)

image.png

语言包下的配置目录结构和MVC对应，控制器对应控制器，文教视图对应视图。配置资源文件命名方式为使用文件的文教文件名称加上语言代码。

image.png

读取资源文件

在控制器中使用，依赖注入资源文件

[ApiController]   [Route("[controller]")]   public class HomeController : ControllerBase   {        private readonly IStringLocalizer<HomeController> _localizer;       public HomeController(IStringLocalizer<HomeController> localizer)       {            _localizer = localizer;       }       [HttpGet]       public string Get()       {            return _localizer["succeed"].Value;//如果找不到succeed的本地化值，服务器托管那么就返回字符串“succeed”       }   } 

测试

有多种方法可以告诉程序需要使用哪一个语言文件，下面只说常见的使用，还支持自定义 。

默认输出

image.png

HTTP报文

和常见的请求一样添加Accept-Language请求头即可

Accept-Language:zh-CN 

image.png

Cookie

默认使用cookie名称.AspNetCore.Culture，值是

c=zh-CN|uic=zh-CN c=zh-CN uic=zh-CN 

c是Culture，uic是UICulture

URL参数

三种写法，效果一样

?culture=zh-CN&ui-culture=zh-CN ?culture=zh-CN ?ui-culture=zh-CN 

image.png

参考文档

https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/localization?view=aspnetcore-5.0