微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

ASP.NET Core之多语言配置

介绍

支持多语言使网站可以覆盖更广泛的受众。 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-20210511223406104

image-20210511223406104

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

image.png

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

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。

相关推荐