这是我参与11月更文挑战的第1天，活动详情查看：2021最后一次更文挑战

介绍

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

本次示例环境：vs2019、net5

配置

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

注入容器

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

启用配置

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
});Copy to clipboardErrorCopied

语言配置文件

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

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

读取资源文件

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

[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”
    }
}Copy to clipboardErrorCopied

测试

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

默认输出

HTTP报文

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

Accept-Language:zh-CNCopy to clipboardErrorCopied

Cookie

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

c=zh-CN|uic=zh-CN
c=zh-CN
uic=zh-CNCopy to clipboardErrorCopied

c是Culture，uic是UICulture

URL参数

三种写法，效果一样

?culture=zh-CN&ui-culture=zh-CN
?culture=zh-CN
?ui-culture=zh-CNCopy to clipboardErrorCopied

参考文档

docs.microsoft.com/zh-cn/aspne…

多语言配置