深入研究.NET Core的本地化机制

ASP.NET Core中提供了一些本地化服务和中间件，可将网站本地化为不同的语言文化。

ASP.NET Core中我们可以使用Microsoft.AspNetCore.Localization库来实现本地化。

在.NET Core 2.0以上版本, Microsoft.AspNetCore.Localization已经包含在了Microsoft.AspNetCore.All中，所以我们并不需要手动引入其他的类库。

创建一个MVC网站

为了测试ASP.NET Core的本地化，我们首先在Visual Studio 2017中创建一个MVC项目LocalizationSample。

640?wx_fmt=png

配置Startup类

ASP.NET Core中，如果希望启动本地化，首先需要在 Startup类的 ConfigureServices方法中使用 services.AddLocalization添加本地化服务。

public void ConfigureServices(IServiceCollection services)	
{	services.AddLocalization(o =>	{	o.ResourcesPath = "Resources";	});	services.AddMvc();	
}

在这个方法中，我们指定了文件夹Resources作为存放翻译文件的目录。

注： 如果不指定存放翻译文件的目录, ASP.NET Core会默认从网站根目录下读取。

然后我们需要在 Configure方法中添加本地化中间件。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)	
{	app.UseStaticFiles();	IList<CultureInfo> supportedCultures = new List<CultureInfo>	{	new CultureInfo("en-US"),	new CultureInfo("zh-CN"),	};	app.UseRequestLocalization(new RequestLocalizationOptions	{	DefaultRequestCulture = new RequestCulture("en-US"),	SupportedCultures = supportedCultures,	SupportedUICultures = supportedCultures	});	app.UseMvc(routes =>	{	routes.MapRoute(	name: "default",	template: "{controller=Home}/{action=Index}/{id?}");	});	
}

  • app.UseRequestLocalization必须放置 app.UseMvc之前

  • DefaultRequestCulture参数指定了默认的语言文化，即用户不指定任何文化时的默认语言文化

  • SupportedCultures和 SupportedUICultures是指定当前应用支持的所有语言文化

注: SupportedCultures指定的是数字和日期格式, SupportedUICultures指定的翻译文件

添加资源文件

下面我们尝试添加一个资源文件

  1. 首先我们创建一个Resources文件夹，这就是我们在前面 Startup类中配置的目录名。

  2. 然后我们在Resource文件夹中添加一个资源文件，并命名为Controllers.HomeController.zh-CN.resx。

  3. 在这个资源文件中，添加一个字段Hello, 并设置其值为“你好”。

640?wx_fmt=png

在Controller中获取本地化字符串

现在我们打开默认生成的 HomeController, 清空里面所有的action, 并添加一个新的action, 代码如下：

public class HomeController : Controller	
{	public HomeController()	{	}	public IActionResult Hello()	{	return Content("Hello");	}	
}

启动项目之后访问/Home/Hello, 结果如下

640?wx_fmt=png

下面我们修改HomeController的代码, 来引入本地化字符串访问器

public class HomeController : Controller	
{	private readonly IStringLocalizer<HomeController> _localizer;	public HomeController(IStringLocalizer<HomeController> localizer)	{	_localizer = localizer;	}	public IActionResult Hello()	{	return Content(_localizer["Hello"]);	}	
}

代码解释

  • IStringLocalizer是一个本地化字符串访问器的泛型接口，这里我们通过依赖注入的方式在 HomeController的构造函数中将其注入

  • 我们可以通过IStringLocalizer的属性访问器获取到对应字段在不同语言下的文本。

最终效果

现在我们启动程序, 重新访问/Home/Hello, 结果如下

640?wx_fmt=png

你会发现结果没有变化，这是因为默认我们设置的语言文化是en-US, 但是我们之前没有添加en-US的资源文件，所以程序就直接将访问的字段名输出了。

现在我们修改URL, 访问/Home/Hello?ui-culture=zh-CN, 结果如下

640?wx_fmt=png

我们期望的“你好”被正确输出了，这说明ASP.NET Core默认支持在Url中以culture参数的形式设置当前网站使用的语言文化。

资源文件命名

为什么我们之前添加了一个名为Controllers.HomeController.zh-CN.resx的资源文件，本地化字符串访问器 IStringLocalizer就能定位到这个文件并读取其中的字段属性呢？

这是由ASP.NET Core资源文件的命名约定决定的。

ASP.NET Core资源文件的名称由2部分组成：

  • 去掉程序集名称的完整类名

  • 语言文化名称

以前面的例子为例： 我们创建了一个本地化字符串访问器接口，它的泛型类型是 HomeController, 其完整类名是 LocalizationSample.Controllers.HomeController, 当前程序集的名称是 LocalizationSample, 所以去掉程序集名称之后，剩余部分是 Controllers.HomeController。当我们设置culture参数是zh-CN时, ASP.NET Core查找的资源文件名是Controllers.HomeController.zh-CN.resx, 这正是我们前面添加的中文语言文化资源文件名。

如果你不喜欢这种方式，ASP.NET Core还提供了另外一种资源文件的组织方式

你可以Resources目录下创建以下目录结构

  • Resources

    • Controllers

      • HomeController.zh-CN.resx

本地化字符串访问器也能自动定位到这个文件。

默认的语言文化提供器

ASP.NET Core的本地化中间件默认支持3种语言文化提供器

  • URL中的查询字符串

  • Cookie

  • 请求头

URL中的查询字符串

ASP.NET Core会从URL中的culture参数中获取当前应用使用的语言文化，这就是前面例子中，“你好”能正确输出的原因

除了指定ui-culture参数，你还可以使用culture参数指定当前格式化时间，数字等所使用的语言文化。

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

Tips: 当只指定culture或ui-culture参数时，ASP.NET Core会自动将culture和ui-culture设置成一样的。即?culture=zh-CN等同于?culture=zh-CN&ui-culture=zh-CN

Cookie

ASP.NET Core中还支持使用Cookie的方式设置当前应用使用的语言文化。默认使用的Cookie名称是.AspNetCore.Culture。

.AspNetCore.Culture的值格式如下

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

其中c表示culture, uic表示ui-culture。

下面我们使用Chrome的开发者工具, 为当前网页添加语言文化Cookie

640?wx_fmt=png

然后我们访问/Home/Hello, "你好"也被正确的输出了640?wx_fmt=png

这说明ASP.NET Core从Cookie中读取到了语言文化配置

请求头

除了URL查询字符串和Cookie, ASP.NET Core还支持在请求头中指定语言文化。请求头中语言文化字段名称是 Accept-Language。

Accept-Language的文档，参见https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Accept-Language

这里我们使用Postman来测试一下，我们设置Accept-Language为zh-CN, zh;q=0.9, 结果如下

640?wx_fmt=png

如何在View中使用本地化

除了Controller, 我们更多的是在View中使用本地化。 如果希望在View中使用本地化，首先需要在 Startup类的 ConfigureServices方法中启用View本地化。

public void ConfigureServices(IServiceCollection services)	
{	services.AddMvc()	.AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix);	
}

这里 LanguageViewLocationExpanderFormat支持2种方式,这个和前面Controller的本地化文件名称约定类似

  • Suffix, 例/Resources/Home/Hello.zh-CN.resx

  • Path, 例/Resources/Home/zh-CN/Hello.resx

下面我们修改HomeController的代码， Hello方法将返回一个View

HomeController

public IActionResult Hello()	
{	//return Content(_localizer["Hello"]);	return View();	
}

Hello.cshtml

@{	ViewData["Title"] = "Hello";	
}	<h2>Good Bye</h2>

然后我们创建如下图的目录结构, 并创建资源文件Hello.zh-CN.resx, 并添加GoodBye字段,其值为"再见"

640?wx_fmt=png

640?wx_fmt=png

使用ViewLocalizer

ViewLocalizer类可以帮助我们在Razor视图中使用本地化文本。现在我们来修改Hello.cshtml, 在文件添加本地化引用，并注入一个ViewLocalizer对象

@using Microsoft.AspNetCore.Mvc.Localization	@inject IViewLocalizer Localizer	
@{	ViewData["Title"] = "Hello";	
}	<h2>@Localizer["GoodBye"]</h2>

这里我们使用ViewLocalizer读取了本地化文本，它的用法和 IStringLocalier一样，都是通过属性访问器访问对应字段的本地化文本。

最终效果

现在我们运行程序并访问/Home/Hello, 结果如下640?wx_fmt=png

然后我们继续访问/Home/Hello?ui-culture=zh-CN, 结果如下640?wx_fmt=png

本地化字符串读取成功

本篇源代码 https://github.com/lamondlu/aspnetcore_localizationsample

640?wx_fmt=jpeg

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/313225.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

.Net Core 3.0 IdentityServer4 快速入门02

.Net Core 3.0 IdentityServer4 快速入门02

.Net Core 3.0 IdentityServer4 快速入门—— resource owner password credentials&#xff08;密码模式&#xff09;一、前言OAuth2.0默认有四种授权模式&#xff08;GrantType&#xff09;&#xff1a;1&#xff09;授权码模式2&#xff09;简化模式3&#xff09;密码模式&a…
阅读更多...
.Net Core3.0 日志 logging

.Net Core3.0 日志 logging

多年的经验&#xff0c;日志记录是软件开发的重要组成部分。没有日志记录机制的系统不是完善的系统。在开发阶段可以通过debug附件进程进行交互调试&#xff0c;可以检测到一些问题&#xff0c;但是在上线之后&#xff0c;日志的记录起到至关重要的作用。它可使我们在系统出现问…
阅读更多...
在微软工作一年，我学会了什么

在微软工作一年，我学会了什么

大家好&#xff0c;我是运营小马。正如我们所知道的那样&#xff0c;10.23日 &#xff0c;崔庆才因为写文写得很痛苦&#xff0c;将公众号转给我运营。10.24 我兴致勃勃又小心翼翼的宣布了我要运营10.25 崔庆才回来了&#xff0c;他说他有喷薄而出抑制不住的写作欲望&#xff0…
阅读更多...
Eclipse调试方法

Eclipse调试方法

http://blog.jobbole.com/93421/ 一、Eclipse调试介绍 二、Eclipse中和Debug相关的视图 2.1 Debug View2.2 Variables View2.3 Breakpoints View2.4 Expressions View2.5 Display View 三、Debug 3.1 设置断点 3.2 调试程序 3.2.1 调试本地 Java 语言程序 3.3.2 远程调试 一、…
阅读更多...
聊聊 Docker Swarm 部署 gRPC 服务的坑

聊聊 Docker Swarm 部署 gRPC 服务的坑

gRPC 是一个高性能、开源和通用的 RPC 框架&#xff0c;面向移动和 HTTP/2 设计&#xff0c;也是目前流行的微服务架构中比较突出的跨语言 RPC 框架。一直以来&#xff0c;我们的微服务都是基于 gRPC 来开发&#xff0c;使用的语言有 .NET、JAVA、Node.js&#xff0c;整体还比较…
阅读更多...
动手造轮子：实现一个简单的依赖注入(零)

动手造轮子：实现一个简单的依赖注入(零)

动手造轮子&#xff1a;实现一个简单的依赖注入(零)Intro依赖注入为我们写程序带来了诸多好处&#xff0c;在微软的 .net core 出来的同时也发布了微软开发的依赖注入框架 Microsoft.Extensions.DependencyInjection&#xff0c;大改传统 asp.net 的开发模式&#xff0c;asp.ne…
阅读更多...
【WPF on .NET Core 3.0】 Stylet演示项目 - 简易图书管理系统(2)

【WPF on .NET Core 3.0】 Stylet演示项目 - 简易图书管理系统(2)

上一章《回忆一下我们的登录逻辑,主要有以下4点:当"用户名"或"密码"为空时, 是不允许登录的("登录"按钮处于禁用状态).用户名或密码不正确时, 显示"用户名或密码不正确"的消息框.用户名输入"waku", 并且密码输入"123&q…
阅读更多...
gRPC 流式调用

gRPC 流式调用

gRPC 使用 Protocol buffers 作为接口定义语言&#xff08;IDL&#xff09;来描述服务接口和输入输出消息的结构&#xff0c;目前支持 4 种定义服务方法类型&#xff1a;类型说明简单 RPC客户端传入一个请求对象&#xff0c;服务端返回一个结果对象客户端流式 RPC客户端传入多个…
阅读更多...
模型压缩案例-SSDYou only look once

模型压缩案例-SSDYou only look once

http://write.blog.csdn.NET/postedit 在上一篇文章中&#xff0c;介绍了以regionproposal来检测的框架&#xff0c;这一系列速度和精度不断提高&#xff0c;但是还是无法达到实时。存在的主要问题为&#xff1a;速度不够快&#xff0c;主要原因是proposal比较多&#xff0c;特…
阅读更多...
.NET如何将字符串分隔为字符

.NET如何将字符串分隔为字符

前言如果这是一道面试题&#xff0c;答案也许非常简单&#xff1a;.ToCharArray()&#xff0c;这基本正确……我们以“AB吉??????”作为输入参数&#xff0c;首先如果按照“正常”处理的思路&#xff0c;用 .ToCharArray()&#xff0c;然后转换为 JSON&#xff08;以便方…
阅读更多...
Orleans 知多少 | 3. Hello Orleans

Orleans 知多少 | 3. Hello Orleans

1. 引言是的&#xff0c;Orleans v3.0.0 已经发布了&#xff0c;并已经完全支持 .NET Core 3.0。所以&#xff0c;Orleans 系列是时候继续了&#xff0c;抱歉&#xff0c;让大家久等了。万丈高楼平地起&#xff0c;这一节我们就先来了解下Orleans的基本使用。2. 模板项目讲解在…
阅读更多...
.NET Core 3.0之深入源码理解ObjectPool（二）

.NET Core 3.0之深入源码理解ObjectPool（二）

写在前面前文主要介绍了ObjectPool的一些理论基础&#xff0c;本文主要从源码角度理解Microsoft.Extensions.ObjectPool是如何实现的。下图为其三大核心组件图&#xff1a;核心组件ObjectPoolObjectPool是一个泛型抽象类&#xff0c;里面只有两个抽象方法&#xff0c;Get和Retu…
阅读更多...
VC维学习

VC维学习

http://www.flickering.cn/machine_learning/2015/04/vc维的来龙去脉/ 说说历史Hoeffding不等式Connection to Learning学习可行的两个核心条件Effective Number of HypothesesGrowth FunctionBreak Point与ShatterVC BoundVC dimension深度学习与VC维小结参考文献 VC维在机器学…
阅读更多...
.NET Core 3.0 一个 jwt 的轻量角色/用户、单个API控制的授权认证库

.NET Core 3.0 一个 jwt 的轻量角色/用户、单个API控制的授权认证库

作者&#xff1a;痴者工良&#xff08;朋友合作原创&#xff09;来源&#xff1a;https://www.cnblogs.com/whuanle/p/11743406.html目录说明一、定义角色、API、用户二、添加自定义事件三、注入授权服务和中间件三、如何设置API的授权四、添加登录颁发 Token五、部分说明六、验…
阅读更多...
.NET Core 3.0 构建和部署

.NET Core 3.0 构建和部署

Default Executables 默认可执行文件 在 dotnet build 或 dotnet publish 期间&#xff0c;将创建一个与你使用的 SDK 的环境和平台相匹配的可执行文件。 和其他本机可执行文件一样&#xff0c;可以使用这些可执行文件执行相同操作&#xff0c;例如&#xff1a; 可以双击可执行…
阅读更多...
为什么我会了SOA，你们还要逼我学微服务？

为什么我会了SOA，你们还要逼我学微服务？

菜菜哥&#xff0c;我最近需要做一个项目&#xff0c;老大让我用微服务的方式来做那挺好呀&#xff0c;微服务现在的确很流行我以前在别的公司都是以SOA的方式&#xff0c;SOA也是面向服务的方式呀的确&#xff0c;微服务和SOA有相同之处面向服务的架构&#xff08;SOA&#xf…
阅读更多...
面对万物互联的智能世界，你是否也想分一杯羹

面对万物互联的智能世界，你是否也想分一杯羹

第六届世界互联网大会于10月20日至22日在浙江乌镇顺利举行。作为世界互联网大会“13”架构的重要组成部分&#xff0c;“互联网之光”博览会以“智能互联网、开放合作——携手共建网络空间命运共同体”为主题&#xff0c;集中展示了全球范围内的互联网新技术、新成果、新产品、…
阅读更多...
你必须知道的容器监控 (2) cAdvisor

你必须知道的容器监控 (2) cAdvisor

# 实验环境&#xff1a;阿里云ECS主机&#xff08;两台&#xff09;&#xff0c;CentOS 7.401—cAdvisor简介为了解决容器的监控问题&#xff0c;Google开发了一款容器监控工具cAdvisor&#xff08;Container Advisor&#xff09;&#xff0c;它为容器用户提供了对其运行容器的…
阅读更多...
代码阅读

代码阅读

http://alanse7en.github.io/caffedai-ma-jie-xi-4/ 三. 从一个比较宏观的层面上去了解caffe怎么去完成一些初始化的工作和使用Solver的接口函数&#xff0c;本文将主要分为四部分的内容&#xff1a; Google Flags的使用Register Brew Function的宏的定义和使用train()函数的…
阅读更多...
动手造轮子：实现一个简单的依赖注入(一)

动手造轮子：实现一个简单的依赖注入(一)

动手造轮子&#xff1a;实现一个简单的依赖注入(一)Intro在上一篇文章中主要介绍了一下要做的依赖注入的整体设计和大概编程体验&#xff0c;这篇文章要开始写代码了&#xff0c;开始实现自己的依赖注入框架。类图首先来温习一下上次提到的类图服务生命周期服务生命周期定义&am…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023