C#中Localization本地化_C#Localization多语言教程【详解】

冬萱酱_9330

冬萱酱_9330

2026-05-22

853人浏览

原创

ResourceManager.GetString() 返回 null 的主因是 baseName 或 assembly 参数不匹配,而非键名错误;baseName 必须严格为“命名空间.文件名”(如"MyApp.Properties.Strings"),大小写敏感且不含.resx,资源文件名中的 culture 标识(如 zh-CN)也须完全一致。

c#中localization本地化_c#localization多语言教程【详解】

ResourceManager.GetString() 返回 null,八成不是键写错了,而是构造时传的 baseName 或 assembly 不对。

ResourceManager 构造参数必须严格匹配命名空间 + 嵌入路径

ResourceManager 本身不“猜”资源在哪,它只按你给的 baseName 和 assembly 去程序集里找 .resources 文件。比如资源文件放在 MyApp.Properties.Strings.resx,那 baseName 必须是 "MyApp.Properties.Strings"(不含 .resx,大小写敏感),不能是 "Strings" 或 "Properties.Strings"。

常见错误现象:

  • 始终 fallback 到默认语言,即使 CurrentUICulture 已设为 zh-CN
  • 调用 GetString("Hello") 返回 null,但用反射查程序集资源清单能看到 MyApp.Properties.Strings.zh-CN.resources 确实存在

实操建议:

  • 确认资源文件的 Access Modifier 设为 Public(VS 属性面板里改),否则 ResourceManager 拿不到内部资源流
  • 桌面应用中,assembly 推荐用 Assembly.GetExecutingAssembly();类库中若被其他项目引用,别误用 Assembly.GetCallingAssembly(),应显式传入包含资源的程序集
  • 用 ildasm 或 dotnet ilc 打开 DLL,检查资源是否真以 Namespace.Filename.culture.resources 形式嵌入(例如 MyApp.Properties.Strings.zh-CN.resources)

WinForms 切换语言后界面不更新?不是资源没加载,是控件没重绘

WinForms 的控件文本不会自动响应 CurrentUICulture 变更——ComponentResourceManager.ApplyResources() 只在初始化时调用一次,之后文化变了,它不会自己跑回来再刷一遍。

使用场景:用户点击语言下拉框,选“中文”,期望所有按钮、标签立刻变中文。

实操建议:

  • 不要只写 Thread.CurrentThread.CurrentUICulture = new CultureInfo("zh-CN")
  • 必须手动触发重应用:遍历窗体或控件树,对每个控件调用 componentResourceManager.ApplyResources(control, control.Name)
  • 如果用了自定义控件,确保其 InitializeComponent() 中的资源加载逻辑也被重新执行,或把本地化逻辑抽到可重入方法里
  • 避免在 Form.Load 事件里读资源——此时 culture 可能还没设好;改在 Form.Shown 或显式初始化函数里做

ASP.NET Core 中 Accept-Language 失效?中间件顺序和配置项漏了

Web 场景下,CurrentUICulture 不由线程决定,而由 RequestLocalizationMiddleware 解析请求头并设置。它不看系统语言,也不管你代码里有没有 Thread.CurrentThread.CurrentUICulture = https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c。

实现基于qmt智能交易终端的A股交易数据本地化
实现基于qmt智能交易终端的A股交易数据本地化

基于QMT平台,支持自然语言指令下载并实时监控A股多周期历史行情,含智能错误处理与任务控制。

下载

常见错误现象:

  • 浏览器发 Accept-Language: zh-CN,zh;q=0.9,en;q=0.8,但服务端日志显示 CurrentUICulture 还是 en-US
  • 用 Postman 手动加 Header 也没用

实操建议:

  • 确认 Program.cs 中 AddLocalization() 在 builder.Services 阶段注册,且 UseRequestLocalization() 在 app.UseRouting() 之后、app.UseEndpoints() 之前调用
  • 检查 RequestLocalizationOptions 是否设置了 SupportedCultures 和 SupportedUICultures,且包含 new CultureInfo("zh-CN") 实例(不能只写字符串)
  • 别依赖 CookieRequestCultureProvider 默认行为——如果没发 cookie,它会 fallback 到 QueryStringRequestCultureProvider 或 AcceptLanguageHeaderRequestCultureProvider,但后者需显式启用

resx 存 HTML 或 JSON 容易出问题,别硬塞

.resx 是 XML 格式,对双引号、&、换行、CDATA 块等处理脆弱。版本合并时冲突高,CI 构建时还可能因编码不一致导致资源加载失败。

性能与兼容性影响:

  • Visual Studio 编辑器自动转义 & → &,运行时 ResourceManager 不会反解,结果页面显示文字里多出 “&”
  • 含
    的字符串在 designer.cs 里生成属性时可能编译报错
  • 某些 CI 环境(如 Linux 上的 dotnet build)对 resx 的 BOM 或编码识别不一致,导致中文乱码
  • 实操建议:

    • 按钮名、提示语、标题等纯文本,继续用 .resx —— 简单、强类型、IDE 支持好
    • 带格式的文案(如“请登录后操作”)、JSON 配置片段、邮件模板,改用独立 .json 文件(如 messages.zh-CN.json),配合 IStringLocalizer 或自定义工厂加载
    • 若必须用 resx 存富文本,手动在 XML 编辑器里写 https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c
]]>,并禁用 VS 的可视化编辑器

最常被忽略的一点:资源文件名拼写必须和 culture 名完全一致——zh-CN 不等于 zh_CN,en-US 不等于 en-us,VS 不校验,但运行时 ResourceManager 严格区分大小写和连字符。一个字母错了,就只能 fallback。调试时先打印 CurrentUICulture.Name,再核对资源文件名,比翻代码快得多。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

多语言 本地化 c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3629

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2448

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1380

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1318

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1416

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2358

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3900

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

18355

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Visual Studio 新手学习
Visual Studio 新手学习

共0课时 | 0人学习

可灵 VIDEO 3.0官方使用手册
可灵 VIDEO 3.0官方使用手册

共0课时 | 0人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习