本地化文本的翻译范围
本地化文本的翻译取决于 UI 会话和当前区域设置。
概述
LocalizedText
变量的翻译取决于会话语言,并且仅在区域设置感知的 UI 会话中发生。区域设置感知的 UI 会话使用当前区域设置的
本地化字典
条目。UI 会话外的对象不使用当前会话区域设置。以下规则说明了 UI 会话和根会话中的翻译行为:
- 翻译仅适用于区域设置感知的 UI 会话。
- 字面量字符串不会自动翻译。
- 仅当文本与本地化条目匹配时,才会进行翻译。
- UI 会话外的对象使用根会话区域设置。
- 默认情况下,根会话区域设置为英语。
翻译范围
以下对象和上下文使用当前会话区域设置进行翻译。
条目 | 说明 |
|---|---|
UI 对象,如标记或文本框,带有指向 本地化字典 中某个键的链接 | 该对象在 UI 会话中运行,并使用当前区域设置。 当链接的键具有当前区域设置的条目时,UI 对象将显示翻译后的文本。 |
具有 字符串格式器 转换器且 Format 属性链接到本地化字典 键的 UI 对象 | 如果图形对象使用 字符串格式器 ,则当 Format 属性与字典条目匹配时,UI 将翻译内容。此行为支持区域设置特定的句子结构。例如,一个区域设置可能使用 Value: {0} ,而另一个区域设置可能使用 {0}:値 。 |
链接到类型为 LocalizedText 的模型变量且链接到本地化字典键的 UI 对象 | 当变量值与本地化字典条目匹配时,UI 对象将显示当前区域设置的翻译。 |
以下对象和上下文不使用当前会话区域设置进行翻译。
条目 | 说明 |
|---|---|
字面量字符串值,无论其在项目中的位置如何 | 如果模型变量包含字面量字符串,则该字符串不会在运行时自动翻译。此行为不会因项目默认区域设置而改变。 |
任何不含直接本地化字典条目的变量,无论其在项目中的位置或数据类型如何 | 不含本地化字典条目的变量不会被翻译。 例如,带有 hello 文本但不含字典映射的标记将保持不变。 |
在 UI 对象外部使用 字符串格式器 转换器和本地化 Format 属性的 LocalizedText 类型变量 | 如果 Format 属性与本地化键匹配,但变量位于 UI 对象外部,则不会进行翻译。不适用于某些对象,例如:报警、事件记录器、报表。 |
translation
localized text
session locale
LocalizationDictionary
提供反馈