Loading [MathJax]/jax/output/CommonHTML/config.js
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >NetCore 国际化最佳实践

NetCore 国际化最佳实践

作者头像
leon公众号精选
发布于 2022-09-01 03:36:28
发布于 2022-09-01 03:36:28
64500
代码可运行
举报
运行总次数:0
代码可运行

NetCore 国际化最佳实践

ASP.NET Core中提供了一些本地化服务和中间件,可将网站本地化为不同的语言文化。ASP.NET Core中我们可以使用Microsoft.AspNetCore.Localization库来实现本地化。但是默认只支持使用资源文件方式做多语言存储,很难在实际场景中使用。有没有可能支持官方资源文件的基础上还能支持动态添加修改多语言呢,答案是有的,那就是NetPro.Globalization

安装

Package Manager方式:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Install-Package NetPro.Globalization 6.0.10

.NET CLI 方式:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
dotnet add package NetPro.Globalization --version 6.0.10

PackageReference:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<PackageReference Include="NetPro.Globalization" Version="6.0.10" />

.NET CLI 方式:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
paket add NetPro.Globalization --version 6.0.10

基于NetPro环境的初始化

如基于NetPro环境的使用,比较简单,在执行安装步骤后配置多语言持久化的sqlite地址即可

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
"Globalization": {
  "UIQueryStringKey": "language", //请求的query携带的多语言参数名,默认为language
  "ConnectionString": "Data Source=Globalization.db;Cache=Shared", //sqlite地址
  "Cultures": [
   "zh-CN",
   "en-US"
  ],
  "Annotations": true, //是否打开注册数据注解本地化服务
  "Record": true //不存在是否记录(自动插入数据库默认语系),默认true
 }

脱离NetPro环境的使用

如不是基于NetPro环境的使用,比需要手动进行各项初始化

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
 public void ConfigureServices(IServiceCollection services)
        {
            services.AddGlobalization();
        }

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
 public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            //置于app.UseRouting()后便可;
            var configuration = app.ApplicationServices.GetService<IConfiguration>();

            var globalization = configuration.GetSection(nameof(Globalization)).Get<Globalization>();

            var cultures = globalization?.Cultures ?? new string[] { };

            var localizationOptions = new RequestLocalizationOptions()
                .AddSupportedUICultures(cultures)
                ;
            localizationOptions.RequestCultureProviders.Insert(0, new QueryStringRequestCultureProvider { UIQueryStringKey = globalization.UIQueryStringKey });
            localizationOptions.RequestCultureProviders.Insert(1, new AcceptLanguageHeaderRequestCultureProvider());
            localizationOptions.RequestCultureProviders.Insert(2, new CookieRequestCultureProvider());
            app.UseRequestLocalization(localizationOptions);
        }

使用

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
 public class GlobalizationDemoController : ControllerBase
    {
        private readonly IStringLocalizer<NetPro.Globalization.Globalization> _localizer;//建议使用NetPro.Globalization.Globalization 统一的类提供字符串承载,过多语言碎片

       
        public GlobalizationDemoController(
            , IStringLocalizer<NetPro.Globalization.Globalization> localizer)
        {
            _localizer = localizer;
        }
        /// <summary>
        /// 多语言国际化示例
        /// </summary>
        [HttpGet("globalization")]
        public IActionResult Globalization()
        {
            var localMsg = _localizer["当前时间为"] + $":{DateTime.Now}";
            return Ok(new { localMsg });
        }
  }

客户端处理

客户端请求接口时,依次支持,query,header,cookie等三种方式携带多语言标识

  • query 默认 language; 支持修改UIQueryStringKey节点覆盖默认参数名,推荐query方式
  • header 默认 Accept-Language
  • cookie 默认为 .AspNetCore.Culture 既:(Microsoft.AspNetCore.Localization.CookieRequestCultureProvider.DefaultCookieName)

实验:

中文环境:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
request http://localhost:5001/api/globalizationdemo/globalization?language=zh-CN
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
response localMsg: "当前时间为:2022/6/11 14:47:01"

英文环境:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
request http://localhost:5001/api/globalizationdemo/globalization?language=en-US
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
response localMsg: "当前时间为:2022/6/11 14:47:01"

发现依然中文,原因是找不到对应的语言,会自动将_localizer[string]中的字符串作为默认值插入,此时只需要手动再插入一条en-US的翻译即可

再次请求:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
request http://localhost:5001/api/globalizationdemo/globalization?language=en-US
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
response localMsg: "This  time is:2022/6/11 14:50:25"

总结

除了以上支持sqlite数据库存储多语言信息,同时也支持微软默认的资源文件方式,并且使用方式与原生一致,不会有新的学习成本。

NetPro.Globalizatio: https://github.com/LeonKou/NetPro/tree/dev_6.0/src/Library/NetPro.Globalization

NetPro框架Github地址: https://github.com/LeonKou/NetPro

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2022-06-11,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 架构师高级俱乐部 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
暂无评论
推荐阅读
编辑精选文章
换一批
一文搞懂企业中软件开发必备技能:git
C语言中文社区git仓库:https://gitee.com/cyyzwsq/C-Coding.git
C语言中文社区
2025/07/02
1310
一文搞懂企业中软件开发必备技能:git
Git禁止大文件提交到仓库中
Git提交的时候,有的时候很容易将目录下的非源代码的文件(如二进制文件、模型等)提交到Git仓库里,给后续的使用造成麻烦。那么有没有一种方法来限制提交到Git的文件的大小呢,答案是Yes,下面我来大概介绍下吧。 原理是利用Git的钩子来在commit之前执行一个脚本,在这个脚本里对提交的文件大小进行检查。
王云峰
2019/12/25
1.9K0
Git共享钩子脚本:实现项目代码的跨仓库同步
Git是现代软件开发中不可或缺的工具之一,它的优势之一在于它可以使用钩子脚本来执行特定的操作以满足各种需求。这篇文章将介绍Git的钩子脚本,重点关注如何使用共享钩子脚本来同步项目代码到其他项目。
八点半的Bruce、D
2023/09/14
1.3K0
Git共享钩子脚本:实现项目代码的跨仓库同步
【Git】Git 完全指南:从入门到精通
Git 是现代软件开发中最重要的版本控制工具之一,它帮助开发者高效地管理项目,支持分布式协作和版本控制。无论是个人项目还是团队开发,Git 都能提供强大的功能来跟踪、管理代码变更,并保障项目的稳定性与可持续发展。本篇文章从基础命令讲起,逐步深入,帮助你全面了解并掌握 Git,最终达到精通。
LuckiBit
2024/12/11
5.5K0
【Git】Git 完全指南:从入门到精通
巧用 gitHooks 提交前校验代码
在每一个使用 git 进行版本管理的仓库,都有一个目录 .git/hooks,包含 commit 各个阶段 Hooks 的脚本。这些 Hooks 在 git 操作 commit、push、merge 等得时候,可以做前置或者后置的操作,例如 pre-commit 在 git commit 前可以做代码校验,校验代码的时候使用的ESLint,格式化使用的是 prettier。Git 支持的常用钩子见下表,更多请查看官网Hooks:
刘小夕
2021/12/09
4.9K0
巧用 gitHooks 提交前校验代码
Git 仓库瘦身与 LFS 大文件存储
熟悉 Git 的小伙伴应该都知道随着 Git 仓库维护的时间越来越久,追踪的文件越来越多,git 存储的 objects 数量会极其庞大,每次从远程仓库 git clone 的时候都会墨迹很久。如果我们不小心 git add 了一个体积很大的文件,且 git push 到了远程仓库,那么我们 git clone 的时候也会很慢。
Cloud-Cloudys
2023/10/21
1K0
Git 仓库瘦身与 LFS 大文件存储
关于使用 Node.js 来辅助进行 CI/CD 的一些想法
  由于使用到的 CI/CD 工具可能会更换,对应的学习成本也相应增加,但是 Node.js 其实可以帮助我们实现这些工具的大部分功能,包括操作文件、执行 cmd 等等。   所以我们如果把大部分的打包或集成操作使用 Node.js 去实现,那么无论工具如何更换,我们只需学习如何使用该工具执行 npm 即可,从而大大降低迁移与学习成本。   当然这只是我最近迁移时的一些解决方案与想法,如果有大佬指教一些其他的方式,那自然是更好啦哈哈哈~
老猫-Leo
2023/12/11
3630
husky+lint-staged助力团队编码规范
Git Hooks 就是在 Git 执行特定事件(如commit、push、receive等)时触发运行的脚本,类似于“钩子函数”,没有设置可执行的钩子将被忽略。
零式的天空
2022/03/28
2.8K0
CMD批处理——forfiles命令使用,自动删除过期备份文件
公司服务器用来备份数据的硬盘过段时间就会被备份文件占满,弄得我老是要登录到服务器去手工删除那些老的文件,有时忘记了就会导致硬盘空间不足而无法备份。 因为只要保留最近几天的备份,如果可以做一个批处理让系统自动删除老备份文件就好了,但是Windows的命令行和Linux的Shell比起来功能差了很多,到底行不行我自己也不清楚。 于是上网查了一下各位大虾发的帖子,再经过自己的摸索和尝试,发现只要花点功夫还是能实现这个功能的。 Windows Server 2003内置的命令行文件,适合于XP以上系统 示例:
landv
2018/05/24
4.7K0
学会这 11 条,你离 Git 大神就不远了!
支持使用 merge 的开发者,他们认为仓库的提交历史就是记录实际发生过什么,它是针对于历史的一个文档,本身其实是有价值的,我们不应该随意修改。我们改变历史的话,就相当于使用“谎言”来掩盖实际发生过的事情,而这些痕迹是应该被保留的。可能,这样并不是很好。
民工哥
2021/04/21
3770
GIT 常用快捷命令
git rm --cached /path/to/file,然后正常 add 和 commit 即可。
Alone88
2019/10/22
1.4K0
Git钩子工具lefthook
lefthook是由 Go 语言开发的适用于多种编程语言项目的快速且强大的 Git 钩子管理器,它可以在项目构建过程中执行一些任务,例如检查代码格式、检查依赖、测试、覆盖率检查、静态分析、持续集成等。官方介绍它的几个特点: 快速,它是用 Go 编写的,可以并行运行命令。 强大,它可以控制执行通过命令传递的执行和文件。 简单,它是一个无依赖的二进制文件,可以在任何环境中工作。
kongxx
2024/05/21
3360
三年 Git 使用心得 & 常见问题整理
「使用场景:」 当你接到一个修复紧急 bug 的任务时候,一般都是先创建一个新的 bug 分支来修复它,然后合并,最后删除。但是,如果当前你正在开发功能中,短时间还无法完成,无法直接提交到仓库,这时候可以先把当前工作区的内容 git stash 一下,然后去修复 bug,修复后,再 git stash pop,恢复之前的工作内容。
Nealyang
2020/06/19
3K0
三年 Git 使用心得 & 常见问题整理
在 .NET 项目中使用 husky 完成 pre-commit 操作
Husky 是一个用于 Git 仓库的工具,主要用于管理 Git 钩子(hooks)。它可以帮助开发者在特定的 Git 操作(如提交、推送等)之前或之后执行自定义的脚本或命令,从而提高代码质量和团队协作效率。
jgrass
2025/03/20
900
在 .NET 项目中使用 husky 完成 pre-commit 操作
技能篇:git的简易教程
在学校,或许凭借一个人的力量就能负责整个项目的开发到上线。但是在在公司,因为项目的复杂性和紧急性,一个项目的往往是由多个人实现,此时就有一个问题,代码提交和代码合并。git和svn,这篇文章来讲讲git的原理和使用
潜行前行
2021/08/20
6140
技能篇:git的简易教程
一篇搞懂Git 和 SVN 的区别【原理篇】
Git和SVN都是版本管理系统,但是他们 命令区别后面会简单进行一个对比,我们先从原理的角度分析
火狼1
2022/03/22
4K0
一篇搞懂Git 和 SVN 的区别【原理篇】
个人git笔记,持续学习并补充填写
创建本地仓库(最好先创建一个目录,在该目录下输入指令创建git仓库),创建完成后该目录下会存在一个.git文件
诺诺的包包
2023/10/15
2000
个人git笔记,持续学习并补充填写
Git分布式版本控制器
  我要出一篇 Git 总结!先讲一下大致步骤: 如果是第一次接触 git 请先克隆仓库: 1.在本地新建项目文件夹,例如在D盘根目录下D:\ md myapp cd myapp 2.从远程git上拷贝下git@开头的url后,命令行输入: git clone git@... 3.配置全局或此项目 用户名、邮箱地址: 全局配置: git config --global user.name "kaixin" git config --global user.email "21577...@qq.com" 此项目配置: git config user.name "kaixin" git config user.email "21577...@qq.com"
我不是费圆
2020/12/17
5580
Git忽略已经提交过一次文件Git忽略文件
也就是添加之后从来没有提交(commit)过的文件,可以使用.gitignore忽略该文件
iOSDevLog
2020/07/03
2.6K0
我是如何使用 Git 和腾讯云 Lighthouse 做图床,并使用 hook 实现 WebP 压缩与水印的?
通常,我们的网站会将图片和网站“骨架”分开进行存储和“解耦”,方便使用 CDN 加速时,图片和网站可以使用不同的方案;也方便网站迁移。
Mintimate
2024/11/16
2771
我是如何使用 Git 和腾讯云 Lighthouse 做图床,并使用 hook 实现 WebP 压缩与水印的?
相关推荐
一文搞懂企业中软件开发必备技能:git
更多 >
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档
本文部分代码块支持一键运行,欢迎体验
本文部分代码块支持一键运行,欢迎体验