WPF 全球化和本地化概述
更新：2007 年 11 月
当您将自己的产品限制为只能通过一种语言使用时，您便将潜在的客户群限制为全球 65 亿人口中的一小部分。如果您想让自己的应用程序被全球用户所接受，那么对产品进行经济而有效的本地化将是赢得更多客户的最好、最经济的方法。
本概述介绍 Windows Presentation Foundation (WPF) 中的全球化和本地化。全球化是指设计和开发在多个地点执行的应用程序。例如，全球化支持适用于不同区域性用户的本地化用户界面和区域数据。WPF 提供全球化设计功能，包括自动布局、附属程序集以及本地化属性和注释。
本地化是针对应用程序所支持的特定区域性将应用程序资源转换为本地化版本的过程。当您在 WPF 中进行本地化时，可以使用 System.Windows.Markup.Localizer 命名空间中的 API。这些 API 支持 LocBaml 工具示例命令行工具。有关如何生成和使用 LocBaml 的信息，请参见如何：对应用程序进行本地化。
本主题包括下列各节。
- 在 WPF 中进行全球化和本地化的最佳做法
- 对 WPF 应用程序进行本地化
- WPF 本地化示例
在 WPF 中进行全球化和本地化的最佳做法
按照本节提供的与 UI 设计和本地化相关的提示操作，可以最大限度地利用 WPF 中内置的大部分全球化和本地化功能。
WPF UI 设计的最佳做法
当您设计基于 WPF 的 UI 时，请考虑实施下列最佳做法：
用 XAML 编写 UI；避免在代码中创建 UI。当您使用 XAML 创建 UI 时，应通过内置的本地化 API 来对其进行公开。
避免使用绝对位置和固定大小来对内容进行布局；相反，应使用相对位置或自动大小调整。
使用 SizeToContent；并将宽度和高度设置为 Auto。
避免使用 Canvas 对 UI 进行布局。
使用 Grid 及其大小共享功能。
在边距中提供额外的空间，因为本地化文本通常需要更多的空间。额外空间为可能会延伸的字符预留了余地。
启用 TextBlock 上的 TextWrapping 以避免剪裁。
设置 xml:lang 属性。此属性描述特定元素及其子元素的区域性。此属性的值可更改 WPF 中的多项功能的行为。例如，它可以更改断字、拼写检查、数字替换、复杂字符造型和字体回退的行为。有关设置 XAML 中 xml:lang 的处理 的更多信息，请参见 Windows Presentation Foundation 全球化。
创建自定义的复合字体，以更好地控制用于不同语言的字体。默认情况下，WPF 使用“Windows\Fonts”目录中的 GlobalUserInterface.composite 字体。
当您创建的导航应用程序可能在以从右到左的格式显示文本的区域性中进行本地化时，请显式设置每个页的 FlowDirection 以确保该页不从 NavigationWindow 继承 FlowDirection。
当您创建在浏览器之外承载的独立导航应用程序时，请将初始应用程序的 StartupUri 设置为 NavigationWindow 而不是页面（例如，<Application StartupUri="NavigationWindow.xaml">）。此设计使您可以更改窗口和导航栏的 FlowDirection。有关更多信息及示例，请参见全球化主页示例。
WPF 本地化的最佳做法
当您对基于 WPF 的应用程序进行本地化时，请考虑实施下列最佳做法：
使用本地化注释为本地化人员提供额外的上下文。
使用本地化属性 (Attribute) 控制本地化，而不是有选择地忽略元素上的 Uid 属性 (Property)。有关更多信息，请参见本地化属性和注释。
使用 msbuild /t:updateuid 和 /t:checkuid 在 XAML 中添加和检查 Uid 属性。使用 Uid 属性跟踪开发和本地化之间的更改。Uid 属性可以帮助您对新的开发更改进行本地化。如果将 Uid 属性手动添加到 UI，则任务通常会比较繁重并且缺乏准确性。
开始进行本地化之后，请不要编辑或更改 Uid 属性。
不要使用重复的 Uid 属性（当您使用“复制并粘贴”命令时，请记住此提示）。
在 AssemblyInfo.* 中设置 UltimateResourceFallback 位置以指定合适的回退语言（例如，[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]）。
如果您决定通过在项目文件中省略 <UICulture> 标记来在主程序集中包括源语言，请将 UltimateResourceFallback 位置设置为主程序集而不是附属程序集（例如，[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.MainAssembly)]）。
对 WPF 应用程序进行本地化
当您对 WPF 应用程序进行本地化时，有多种选择。例如，您可以将应用程序中的可本地化资源绑定到 XML 文件，在 resx 表中存储可本地化的文本，或者让本地化人员使用 可扩展应用程序标记语言 (XAML) 文件。本节介绍使用二进制 XAML (BAML) 的本地化工作流，该工作流有以下几个好处：
可以在生成之后进行本地化。
可以通过本地化从较低版本的 BAML 更新到更高版本的 BAML，以便在开发的同时进行本地化。
因为 BAML 是 XAML 的已编译形式，所以可以在编译时验证原始源元素和语义。
本地化生成过程
开发 WPF 应用程序时，本地化的生成过程如下：
开发人员创建并全球化 WPF 应用程序。在项目文件中，开发人员设置 <UICulture>en-US</UICulture>，以便在编译应用程序时生成一个非特定语言主程序集。此程序集具有一个附属 .resources.dll 文件，该文件包含所有可本地化的资源。因为我们的本地化 API 支持从主程序集进行提取，所以可选择在主程序集中保留源语言。
在将文件编译到生成中时，会将 XAML 转换为 BAML。非特定区域性的 MyDialog.exe 和区域相关的（英语）MyDialog.resources.dll 文件将发布到说英语的客户手中。
本地化工作流
在生成未本地化的 MyDialog.resources.dll 文件之后，本地化过程便开始了。使用 System.Windows.Markup.Localizer 下的 API 将原始 XAML 中的 UI 元素和属性从 BAML 提取为键/值对。本地化人员使用键/值对来对应用程序进行本地化。在本地化完成之后，您可以从新值生成一个新的 .resource.dll。
键/值对的键是开发人员放置在原始 XAML 中的 x:Uid。这些 x:Uid 使 API 可以跟踪和合并在本地化过程中发生在开发人员与本地化人员之间的更改。例如，如果在本地化人员开始进行本地化之后，开发人员更改了 UI，则您可以将开发更改与已经完成的本地化工作进行合并，以便使损失的翻译工作达到最少。
下图显示了一个基于 BAML 的典型本地化工作流。此关系图假设开发人员用英语编写应用程序。开发人员创建 WPF 应用程序并将其全球化。在项目文件中，开发人员设置 <UICulture>en-US</UICulture>，以便在生成时会生成一个非特定语言主程序集，并且使该程序集具有一个包含所有可本地化资源的附属 .resources.dll。或者，因为 WPF 本地化 API 支持从主程序集进行提取，所以还可以保留主程序集中的源语言。生成过程结束之后，XAML 会被编译为 BAML。非特定区域性的 MyDialog.exe.resources.dll 将被发布到说英语的客户手中。
.png)
.png)
一旦生成未本地化的 MyDialog.resources.dll，本地化过程便会开始。然后，可以使用 System.Windows.Markup.Localizer 命名空间中的 API 将原始 XAML 中的 UI 元素和属性从 BAML 提取为键/值对。这样，本地化人员便可以通过处理键/值对来对应用程序进行本地化。一旦本地化完成，便可以从新值生成一个新的 .resource.dll。
键/值对的键是开发人员放置在原始 XAML 中的 x:UId。这些 x:UId 使 API 可以跟踪和合并在本地化过程中发生在开发人员与本地化人员之间的更改。例如，如果在本地化人员已经开始进行本地化之后，开发人员对 UI 进行了更改，则可以将开发更改与已经完成的本地化工作进行合并，以便使损失的翻译工作达到最少。
WPF 本地化示例
本节包含几个本地化应用程序示例，以帮助您了解如何生成和本地化 WPF 应用程序。
“运行”对话框示例
下图显示“运行”对话框示例的输出。
英语：
.png)
德语：
.png)
设计一个全球化“运行”对话框
此示例使用 WPF 和 XAML 生成一个“运行”对话框。此对话框与 Microsoft Windows“开始”菜单中包含的“运行”对话框等效。
有关完整示例，请参见 全球化“运行”对话框示例。
生成全球化对话框的一些要点包括：
Automatic Layout
在 Window1.xaml 中：
<Window SizeToContent="WidthAndHeight">
以前的 Window 属性会根据内容的大小自动调整窗口的大小。此属性可以防止窗口切断在本地化之后增加大小的内容；它还可以在内容由于本地化而减小大小时移除不必要的空格。
<Grid x:Uid="Grid_1">
为了使 WPF 本地化 API 可以正确运行，需要使用 Uid 属性。
WPF 本地化 API 使用这些属性来跟踪 用户界面 (UI) 的开发和本地化之间的更改。使用 Uid 属性可以将较高版本的 UI 与较低版本的 UI 进行合并。通过在 Windows SDK 命令外壳程序中运行 msbuild /t:updateuid RunDialog.csproj 可以添加 Uid 属性。因为手动添加 Uid 属性通常比较费时并且准确性较差，所以建议使用此方法来添加这些属性。可以通过运行 msbuild /t:checkuid RunDialog.csproj 来检查是否正确设置了 Uid 属性。
使用 Grid 控件可以构造 UI，该控件对利用 WPF 中的自动布局很有用处。请注意，对话框被拆分成三行五列。没有一个行和列定义具有固定大小；因此，位于每个单元格中的 UI 元素能够在本地化过程中适应大小的增加和减小。
放置“Open:”（打开:）标签和 ComboBox 的前两列占用了 UI 的总宽度的 10%。
请注意，此示例使用了 Grid 的共享大小调整功能。最后三列通过将自身放置在相同的 SharedSizeGroup 中利用此功能。正如您可以从属性的名称中看出的那样，此属性使不同的列可以采用相同的大小。因此，在将“Browse…”本地化为更长的字符串“Durchsuchen…”时，所有按钮的宽度都会增加，而不是显示一个小的“OK”按钮和一个大得不相称的“Durchsuchen…”按钮。
Xml:lang
Xml:lang="en-US"
请注意放置在 UI 的根元素中的 XAML 中 xml:lang 的处理。此属性描述给定元素及其子元素的区域性。WPF 中的多项功能都使用此值，在本地化过程中应对此值进行相应的更改。此值会更改在断字以及对字词进行拼写检查时所使用的字典。它还会影响数字的显示以及字体回退系统选择所用字体的方式。最后，该属性会影响数值的显示方式以及用复杂字母书写的文本的造型方式。默认值为“en-US”。
Building a Satellite Resource Assembly
在 .csproj 中：
<UICulture>en-US</UICulture>
请注意，增加了 UICulture 属性。如果将此属性设置为有效的 CultureInfo 值（例如，“en-US”），生成项目时会产生一个包含所有可本地化的资源的附属程序集。
<Resource Include="RunIcon.JPG">
<Localizable>False</Localizable>
</Resource>
因为对于所有区域性 RunIcon.JPG 都应具有同样的外观，所以不需要对它进行本地化。Localizable 被设置为 False，以使其保留在非特定语言主程序集而不是附属程序集中。所有不可编译资源的 Localizable 的默认值都设置为 True。
对“运行”对话框进行本地化
Parse
生成应用程序之后，对其进行本地化的第一步是将可本地化的资源从附属程序集中分析出来。对于本主题而言，请使用 LocBaml 工具示例中包含的示例 LocBaml 工具。请注意，LocBaml 只是一个示例工具，其目的是帮助您了解有关如何生成适合您的本地化过程的本地化工具的入门知识。使用 LocBaml 可以运行下面的命令以进行分析：LocBaml /parse RunDialog.resources.dll /out:，从而生成“RunDialog.resources.dll.CSV”文件。
Localize
使用您所选的支持 Unicode 的 CSV 编辑器来编辑此文件。筛选掉本地化类别为“None”的所有项。您应看到下面的项：
资源键 |
本地化类别 |
值 |
Button_1:System.Windows.Controls.Button.$Content |
按钮 |
OK |
Button_2:System.Windows.Controls.Button.$Content |
按钮 |
Cancel |
Button_3:System.Windows.Controls.Button.$Content |
按钮 |
Browse... |
ComboBox_1:System.Windows.Controls.ComboBox.$Content |
组合框 |
|
TextBlock_1:System.Windows.Controls.TextBlock.$Content |
文本 |
Type the name of a program, folder, document, or Internet resource, and Windows will open it for you. |
TextBlock_2:System.Windows.Controls.TextBlock.$Content |
文本 |
Open: |
Window_1:System.Windows.Window.Title |
标题 |
Run |
将该应用程序本地化为德语版本需要进行下面的翻译：
资源键 |
本地化类别 |
值 |
Button_1:System.Windows.Controls.Button.$Content |
按钮 |
OK |
Button_2:System.Windows.Controls.Button.$Content |
按钮 |
Abbrechen |
Button_3:System.Windows.Controls.Button.$Content |
按钮 |
Durchsuchen… |
ComboBox_1:System.Windows.Controls.ComboBox.$Content |
组合框 |
|
TextBlock_1:System.Windows.Controls.TextBlock.$Content |
文本 |
Geben Sie den Namen eines Programms, Ordners, Dokuments oder einer Internetresource an. |
TextBlock_2:System.Windows.Controls.TextBlock.$Content |
文本 |
Öffnen: |
Window_1:System.Windows.Window.Title |
标题 |
Run |
Generate
本地化的最后一步涉及到创建新近本地化的附属程序集。可以使用下面的 LocBaml 命令完成此操作：
LocBaml.exe /generate RunDialog.resources.dll /trans:RunDialog.resources.dll.CSV /out: . /cul:de-DE
在德语版 Windows 上，如果此 resources.dll 被放置在主程序集旁边的“de-DE”文件夹中，则会自动加载此资源而不是“en-US”文件夹中的资源。如果您没有德语版的 Windows 来对此进行测试，请将区域性设置为您所使用的 Windows 的区域性（例如，en-US），并替换原始的 resources.dll。
Satellite Resource Loading
MyDialog.exe |
en-US\MyDialog.resources.dll |
de-DE\MyDialog.resources.dll |
|---|---|---|
代码 |
原始英语 BAML |
本地化 BAML |
非特定区域性资源 |
其他英语资源 |
其他被本地化到德语的资源 |
.NET Framework 根据应用程序的 Thread.CurrentThread.CurrentUICulture 自动选择要加载的附属资源程序集。其默认设置为您的 Windows 操作系统的区域性。因此，如果您使用的是德语版 Windows，则会加载 de-DE\MyDialog.resources.dll；如果您使用的是英语版 Windows，则会加载 en-US\MyDialog.resources.dll。通过在项目的 AssemblyInfo.* 中指定 NeutralResourcesLanguage，可以设置应用程序的最终回退资源。例如，如果您指定：
[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]
则如果 de-DE\MyDialog.resources.dll 和 de\MyDialog.resources.dll 都不可用，则德语版 Windows 将使用 en-US\MyDialog.resources.dll。
Microsoft 沙特阿拉伯主页
下图显示了英语和阿拉伯语主页。有关产生这些图形的完整示例，请参见全球化主页示例。
英语：
.jpg)
阿拉伯语：
.jpg)
设计全球 Microsoft 主页
Microsoft 沙特阿拉伯网站的这个实体模型阐释了针对 RightToLeft 语言提供的全球化功能。诸如希伯来语和阿拉伯语之类的语言具有从右到左的阅读顺序，因此 UI 的布局方式通常必须与英语等从左到右的语言中的布局方式不同。从从左到右的语言本地化到从右到左的语言或者反过来都可能颇具挑战性。WPF 旨在使此类本地化工作变得更容易。
FlowDirection
Homepage.xaml：
请注意页面上的 FlowDirection 属性，将此属性更改为“RightToLeft”将更改页面的 FlowDirection 及其子元素，以使此 UI 的布局如阿拉伯语用户所期望的那样翻转为从右到左。可以通过在任何元素上指定显式的 FlowDirection 来重写继承行为。FlowDirection 属性在所有 FrameworkElement 或文档相关元素上都可用，并且具有显式值“LeftToRight”。
请注意，当根页面的 FlowDirection 发生更改时，甚至连背景渐变画笔都进行了正确的翻转：
FlowDirection="LeftToRight"
.png)
FlowDirection="RightToLeft"
.png)
避免对面板和控件使用固定维度
请浏览一下 Homepage.xaml，您会注意到，除了为顶级 DockPanel 上的整个 UI 指定的固定宽度和高度之外，没有其他固定维度。请避免使用固定维度，以防止对可能比源文本长的本地化文本进行剪裁。WPF 面板和控件将根据它们所包含的内容自动调整大小。大多数控件还具有最小和最大维度，您可以设置这些维度以获得更多控制（例如，MinWidth= “20”）。对于 Grid，您还可以使用“*”来设置相对宽度和高度（例如，Width= “0.25*”），或者如“运行”对话框示例中所示，使用该控件的单元格大小共享功能。请参见全球化“运行”对话框示例。
本地化注释
在很多情况下，内容可能不太明确，难以翻译。开发人员或设计人员能够通过本地化注释为本地化人员提供额外的上下文和注释。例如，下面的 Localization.Comments 阐明了字符“|”的用法。
此注释与 TextBlock_1 的内容相关联，并且在使用 LocBaml 工具（请参见如何：对应用程序进行本地化）时，可以在输出 .csv 文件的 TextBlock_1 行的第六列看到此注释：
资源键 |
类别 |
可读性 |
可修改性 |
注释 |
值 |
TextBlock_1:System.Windows.Controls.TextBlock.$Content |
文本 |
TRUE |
TRUE |
此字符被用作装饰性规则。 |
| |
使用下面的语法可以将注释放置在任何元素的内容或属性上：
本地化属性
通常，开发人员或本地化经理需要控制本地化人员能够阅读和修改的内容。例如，您可能不希望本地化人员翻译贵公司的名称或法律用语。WPF 提供了一些属性，使用这些属性可以设置元素的内容或属性的可读性、可修改性和类别，而本地化工具可以使用这些设置来锁定、隐藏元素或对元素进行排序。有关更多信息，请参见 AttributesProperty。对于本示例而言，LocBaml 工具仅输出这些属性的值。WPF 控件对这些属性都使用默认值，但您可以重写这些属性。例如，下面的示例重写 TextBlock_1 的默认本地化属性，并将内容设置为可供本地化人员阅读，但不能供其修改。
<TextBlock
x:Uid="TextBlock_1"
Localization.Attributes=
"$Content(Readable Unmodifiable)">
Microsoft Corporation
</TextBlock>
除了可读性和可修改性属性之外，WPF 还提供了常见 UI 类别的枚举，使用该枚举可以为本地化人员提供更多的上下文：文本、标题、Label、Button、CheckBox、ComboBox、ListBox、Menu、RadioButton、ToolTip、Hyperlink、文档、XmlData 和字体。平台控件的 WPF 默认类别也可以在 XAML 中重写：
<TextBlock x:Uid="TextBlock_2">
<TextBlock.ToolTip>
<TextBlock
x:Uid="TextBlock_3"
Localization.Attributes=
"$Content(ToolTip Readable Unmodifiable)">
Microsoft Corporation
</TextBlock>
</TextBlock.ToolTip>
Windows Vista
</TextBlock>
WPF 所提供的默认本地化属性还可以通过代码进行重写，因此您可以正确地为自定义控件设置合适的默认值。例如：
[Localizability(Readability = Readability.Readable, Modifiability=Modifiability.Unmodifiable, LocalizationCategory.None)]
public class CorporateLogo: TextBlock
{
…
..
.
}
在 XAML 中设置的特定于实例的属性优先于在自定义控件的代码中设置的值。有关属性和注释的更多信息，请参见本地化属性和注释。
字体回退和复合字体
如果您指定一种不支持给定码位范围的字体，则 WPF 将使用位于“Windows\Fonts”目录中的 Global User Interface.compositefont 自动回退到支持该范围的字体。复合字体与任何其他字体的用法一样，通过设置元素的 FontFamily（例如，FontFamily= “Global User Interface”）可以显式使用复合字体。通过创建您自己的复合字体并指定针对特定码位范围和语言所使用的字体，可以指定您自己的字体回退首选项。
有关复合字体的更多信息，请参见 FontFamily。
本地化 Microsoft 主页
可以按照“运行”对话框示例中的相同步骤对此应用程序进行本地化。在全球化主页示例中可以找到本地化的阿拉伯语 .csv 文件。