开篇语
首先非常感谢各位朋友或技术爱好者的关注。
介绍
支持多语言使网站可以覆盖更广泛的受众。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结尾)存放路径需要和使用的地方目录结构一致。(右键文件夹>添加>新建项)
语言包下的目录结构和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”}}
测试
有多种方法可以告诉程序需要使用哪一个语言文件,下面只说常见的使用,还支持自定义 。
默认输出
HTTP报文
和常见的请求一样添加Accept-Language请求头即可
Accept-Language:zh-CN
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
参考文档
https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/localization?view=aspnetcore-5.0
注:
最近文章的更新频率有点低(工作有点忙,所以花的时间有点多),但是我会尽可能的维持文章的内容质量,如果文章内容有误或者有其他建议,麻烦请联系我。
如果您觉得文章内容还行,麻烦请您点个赞或点个在看,这是对我的一种支持,谢谢。