0

0

Blazor 怎么进行国际化和本地化

星降

星降

发布时间:2026-01-28 12:30:37

|

275人浏览过

|

来源于php中文网

原创

Blazor国际化核心是识别多语言环境并正确显示文本、日期等,需注册本地化服务、配置文化支持、准备资源文件、注入本地化器使用文本、实现运行时切换语言。

blazor 怎么进行国际化和本地化

Blazor 实现国际化(i18n)和本地化(l10n)核心是两件事:让应用能识别多种语言环境,再把界面文本、日期、数字等按当前语言正确显示。不依赖第三方 UI 库也能做,但用 BootstrapBlazor、MudBlazor 或 Ant Design Blazor 会更省事——它们都内置了成熟方案。

注册本地化服务并配置文化支持

无论用哪个组件库,第一步都是在 Program.cs 中注册 .NET 原生本地化服务,并声明支持的语言列表:

  • 调用 builder.Services.AddLocalization(),指定资源路径(如 ResourcesLocalization
  • 添加对应 UI 库的本地化扩展,例如:
     • BootstrapBlazor:AddBootstrapBlazor(options => options.DefaultCulture = "zh-CN")
     • MudBlazor:AddMudLocalization()
     • Ant Design Blazor:AddAntDesign() 自动集成
  • 配置 RequestLocalizationOptions,设置默认文化、支持的文化数组(如 ["en-US", "zh-CN", "fr-FR"]),并启用中间件 app.UseRequestLocalization()

准备多语言资源文件

资源文件是翻译内容的载体,主流方式有两种:

  • JSON 文件(推荐用于 BootstrapBlazor / Ant Design)
     • 放在 Localization/ 目录下
     • 命名如 en-US.jsonzh-CN.json
     • 结构支持嵌套键,例如:{"Components.Table": {"AddButtonText": "New"}}
  • .resx 资源文件(.NET 传统方式,适合 MudBlazor 或自定义场景)
     • 按命名规范如 Button.en-US.resxButton.zh-CN.resx
     • 可放在 Resources/Components/ 下,便于按模块管理
     • Visual Studio 会自动生成强类型类,支持编译时检查

在组件中使用本地化文本

不用硬编码字符串,而是通过注入本地化器获取动态文本:

奇布塔
奇布塔

基于AI生成技术的一站式有声绘本创作平台

下载
  • 在 Razor 组件顶部注入:@inject IStringLocalizer Localizer(对应 .resx)或 @inject IStringLocalizer Localizer(通用)
  • 在 HTML 中直接使用:@Localizer["SaveButton"] 或带参数:@Localizer["HelloName", userName]
  • 组件库自带的按钮、表格等,只要用了其标准属性(如 TextConfirmContentText),且资源键匹配,就会自动翻译

运行时切换语言

用户点一下就换语言,关键在于更新当前线程的 CultureInfo 并触发重绘

  • 调用 LocaleProvider.SetLocale("en-US")(Ant Design)
  • 或手动设置:
    CultureInfo.CurrentCulture = new CultureInfo("fr-FR");
    CultureInfo.CurrentUICulture = new CultureInfo("fr-FR");
  • 最后别忘了 StateHasChanged() 或触发页面刷新(如跳转带 culture 参数的 URL)
  • 常见做法是加一个语言切换下拉框,选中后保存到 localStorage 或 Cookie,下次加载自动读取

基本上就这些。重点不是堆砌配置,而是资源键统一、文化切换可靠、回退机制健全(比如 zh-CN 找不到就试 zh,再不行回 en-US)。做起来不复杂,但容易忽略缓存、路径拼写、大小写一致性这些细节。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

178

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

214

2025.12.18

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

418

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

535

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6427

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

347

2023.11.23

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

84

2026.01.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

AngularJS教程
AngularJS教程

共24课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 24.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号