Asp.net Core 多语言本地化 一些自己的思路和做法

  • A+
所属分类:.NET技术
摘要

多语言,已成为必不可少的需求了,在Asp.net Core中解决起来很方便。实现一个多语言的网站只要几分钟。


多语言,已成为必不可少的需求了,在Asp.net Core中解决起来很方便。实现一个多语言的网站只要几分钟。

 

1.环境:VS2019+Asp.net Core 5(适用于3.1,其实就是追个新)

2.新建项目

Asp.net Core 多语言本地化 一些自己的思路和做法

因为是一个空项目,所以为了多点内容,就加入了一些基架内容,添加了Identity的自动生成内容

如何生成:https://docs.microsoft.com/zh-cn/aspnet/core/security/authentication/scaffold-identity?view=aspnetcore-5.0&tabs=visual-studio

看这里吧。不多说了。就是添加一些登陆页面之类的

正好它是英文滴

 

2.现在我们来添加多语言

打开配置文件appsettings.json,在配置文件中添加如下内容,其实这是把语言写在了配置中,这样方便以后操作,可以自己后台操作,也可以用代码操作。

  "Localization": {     "CultureInfo": "en-US,zh-CN",     "Default": "en-US"

 

3.打开startup.cs文件

在ConfigureServices中添加如下配置

services.AddLocalization(options => options.ResourcesPath = "Resources");  services.AddMvc()     .AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix)     .AddDataAnnotationsLocalization();

 

在中间件注册中,添加如下代码(注意:这个应该在app.UseStaticFiles之前注册,不然会没反应),这里正好读的是配置文件里的支持的语言和默认语言,查了一下资料,这里的默认语言的意思是

当没有本地文件时,会以什么语言显示。也就是如果有本地语言,会加载支持的语言

//Localization             var supportedCultures = Configuration["Localization:CultureInfo"].Split(",");             var localizationOptions = new RequestLocalizationOptions().SetDefaultCulture(Configuration["Localization:Default"])                 .AddSupportedCultures(supportedCultures)                 .AddSupportedUICultures(supportedCultures);              app.UseRequestLocalization(localizationOptions);

4.前端操作,打开_ViewImports.cshtml,添加对本地化的引用,共两行

@using AquaWebCore @using AquaWebCore.Models @using Microsoft.AspNetCore.Mvc.Localization @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers @inject IViewLocalizer Localizer

下面我们来修改一下前端页面,Views目录中的任意文件,就先拿Home开刀吧

@{     ViewData["Title"] = @Localizer["Home Page"]; }  <div class="text-center">     <h1 class="display-4">@Localizer["Welcome"]</h1>     <p>@Localizer["Learn aboutLearn about"]<a href="https://docs.microsoft.com/aspnet/core">@Localizer["building Web apps with ASP.NET Core"]</a>.</p> </div>

其实就是在每一个文本前加上@Localizer

5 .添加资源文件

在Resources目录下建立一个和程序目录相同的资源文件,在这个文件命名上有讲究,ResourcesViewsHomeIndex.zh-CN.resx,就是文件名.地区名.resx

Asp.net Core 多语言本地化 一些自己的思路和做法

6.编辑资源文件

Asp.net Core 多语言本地化 一些自己的思路和做法

 7.运行一下,多语言 就显示了

Asp.net Core 多语言本地化 一些自己的思路和做法

8.其它配置

浏览器选择:http://localhost:5000/?culture=zh-CN

js cookie操作:c=zh-CN|uic=en-US(其中 c 是 Cultureuic 是 UICulture)

可以灵活控制当前显示

//////////////////////////////////////////////////

参考资料:

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