如何在 C# 中使用本地化

Question

我似乎无法让本地化发挥作用。

我有一个班级图书馆。 现在我想在其中创建 resx 文件，并根据线程区域性返回一些值。

我怎样才能做到这一点？

Answer 1

• 通过执行以下操作，将资源文件添加到您的项目（您可以将其称为“strings.resx”）：
  右键单击项目中的属性，选择添加 -> 添加资源文件。 在上下文菜单中新建项目...，然后在 Visual C# 项目列表中选择“资源文件”并将其命名为 strings.resx。
• 在 resx 文件中添加一个字符串资源并为其指定一个好名称（例如：将其命名为“Hello”并为其指定值“Hello”）
• 保存资源文件（注意：这将是默认资源文件，因为它没有两个字母的语言代码）
• 添加对程序的引用：System.Threading 和 System.Globalization

运行此代码：

Console.WriteLine(Properties.strings.Hello);

它应该打印“Hello”。

现在，添加一个名为“strings.fr.resx”的新资源文件（请注意“fr”部分；该文件将包含法语资源）。 添加与 strings.resx 中名称相同的字符串资源，但值采用法语（Name="Hello"，Value="Salut"）。 现在，如果运行以下代码，它应该打印 Salut:

Thread.CurrentThread.CurrentUICulture = CultureInfo.GetCultureInfo("fr-FR");
Console.WriteLine(Properties.strings.Hello);

发生的情况是系统将查找“fr-FR”的资源。 它不会找到一个（因为我们在您的文件中指定了“fr””）。然后它将回退到检查它找到（并使用）的“fr”。

以下代码将打印“Hello”：

Thread.CurrentThread.CurrentUICulture = CultureInfo.GetCultureInfo("en-US");
Console.WriteLine(Properties.strings.Hello);

即因为它没有找到任何“en-US”资源，也没有“en”资源，因此它将回退到默认值，这是我们从一开始就添加的资源，

如果您可以创建包含更具体资源的文件 。需要（例如 strings.fr-FR.resx 和 strings.fr-CA.resx 分别用于法国和加拿大的法语）。因此，如果法国和加拿大的文本相同，则可以将其放入 strings.fr.resx，而加拿大法语中不同的字符串可以放入 strings.fr-CA.resx。

Answer 2

实际上，这很简单。 创建一个新的资源文件，例如 Strings.resx。 将访问修饰符设置为公共。 使用适当的文件模板，Visual Studio 将自动生成一个访问器类（在本例中，名称为 Strings）。 这是您的默认语言。

现在，当您想要添加德语本地化时，请添加本地化的 resx 文件。 在这种情况下，这通常是Strings.de.resx。 如果您想添加额外的本地化（例如奥地利），您还需要创建一个 Strings.de-AT.resx。

现在创建一个字符串 - 假设一个名为 HelloWorld 的字符串。 在 Strings.resx 中，添加此字符串，其值为“Hello, world!”。 在 Strings.de.resx 中，添加“Hallo，Welt！”。 在 Strings.de-AT.resx 中添加“Servus，Welt！”。 到目前为止就是这样。

现在您已经生成了 Strings 类，并且它有一个带有 getter HelloWorld 的属性。 获取此属性将加载“Servus，Welt！” 当您的语言环境是 de-AT 时，“Hallo, Welt!”当您的语言环境是任何其他 de 语言环境（包括 de-DE 和 de-CH）时，以及“Hello, World!”当您的语言环境是其他语言时。在本地化版本中缺少，资源管理器将自动沿着链向上移动，从最专业的资源到不变的资源，

您可以使用 ResourceManager 类来更好地控制加载内容的方式。生成的 Strings 类也使用它。

Answer 3

此外，@Fredrik Mörk 对字符串的精彩回答，要添加本地化到表单，请执行以下操作：

• 设置表单的属性“可本地化”更改为 true
• 将表单的 Language 属性更改为您想要的语言（从包含所有内容的漂亮下拉列表中）
• 翻译该表单中的控件，并在需要时移动它们be（压缩那些非常长的完整法语句子！）

编辑：这个 有关本地化 Windows 窗体 的 MSDN 文章不是我链接的原始文章...但如果需要的话可能会提供更多信息。 （旧的已经被拿走了）

Answer 4

F.Mörk 的回答很好。 但是，如果您想在应用程序发布后更新翻译或添加新语言，您就会陷入困境，因为您总是必须重新编译它以生成 resources.dll。

这里提供一个手动编译资源dll的解决方案。 它使用 resgen.exe 和 al.exe 工具（与 sdk 一起安装）。

假设您有一个 Strings.fr.resx 资源文件，您可以使用以下批处理编译资源 dll：

resgen.exe /compile Strings.fr.resx,WpfRibbonApplication1.Strings.fr.resources 
Al.exe /t:lib /embed:WpfRibbonApplication1.Strings.fr.resources /culture:"fr" /out:"WpfRibbonApplication1.resources.dll"
del WpfRibbonApplication1.Strings.fr.resources
pause

请务必保留文件名中的原始命名空间（此处为“WpfRibbonApplication1”）

Answer 5

修复并阐述了 @Fredrik Mörk 答案。

• 将 strings.resx 资源文件添加到您的项目（或不同的文件名）
• 将 Access Modifier 设置为 Public（在打开的 strings 中） .resx 文件选项卡）
• 在 resx 文件中添加字符串资源：（示例：名称 Hello，值 Hello）
• 资源文件

保存Visual Studio 自动生成的 相应的 strings 类，它实际上放置在 strings.Designer.cs 中。 该类与您期望放置新创建的 .cs 文件位于同一命名空间中。

此代码始终打印 Hello，因为这是默认资源，并且没有特定于语言的资源可用：

Console.WriteLine(strings.Hello);

现在添加一个新的特定于语言的资源：

• 添加 strings.fr.resx （法语）
• 添加一个与之前名称相同但值不同的字符串：(name < code>Hello, value Salut)

以下代码打印 Salut:

Thread.CurrentThread.CurrentUICulture = CultureInfo.GetCultureInfo("fr-FR");
Console.WriteLine(strings.Hello);

使用什么资源取决于 Thread.CurrentThread.CurrentUICulture。 它根据 Windows UI 语言设置进行设置，或者可以像本示例中那样手动设置。 此处了解有关此内容的更多信息。

您可以添加特定于国家/地区的资源，例如 strings.fr-FR.resx 或 strings.fr-CA.resx。

要使用的字符串按以下优先顺序确定：

• 来自特定于国家/地区的资源，例如 strings.fr-CA.resx
• 来自特定于语言的资源，例如 strings.fr.resx
• 从默认 strings.resx

请注意，特定于语言的资源会生成 卫星程序集。

另请在此处了解 CurrentCulture 与 CurrentUICulture 有何不同。

Answer 6

通常，您将翻译放在资源文件中，例如 resources.resx。

每种特定的文化都有不同的名称，例如 resources.nl.resx、resources.fr.resx、resources.de.resx……

现在解决方案最重要的部分是维护您的翻译。
在 Visual Studio 中安装 Microsoft MAT 工具：多语言应用程序工具包 (MAT)。
适用于 winforms、wpf、asp.net（核心）、uwp...

一般情况下，例如对于 WPF 解决方案，在 WPF 项目中

• 安装 Visual Studio 的 Microsoft MAT 扩展。
• 在解决方案资源管理器中，导航到您的项目 > 属性> AssemblyInfo.cs
• 在 AssemblyInfo.cs 中添加您的默认中性语言（在我的例子中是英语）： [assemble: System.Resources.NeutralResourcesLanguage("en")]
• 在解决方案资源管理器和 Visual 中选择您的项目Studio，从顶部菜单中单击“工具”> “多语言应用程序工具包”> “启用选择”，为项目启用 MAT。
  • 现在，在解决方案资源管理器中右键单击该项目，选择“多语言应用程序工具包”> “添加翻译语言...”并选择您要添加翻译的语言。 例如荷兰语。

您将看到，将创建一个名为“MultilingualResources”的新文件夹，其中包含一个 ....nl.xlf 文件。

您现在唯一要做的就是：

1. 将翻译添加到默认的 resources.resx 文件（在我的例子中是英语）中，
2. 通过单击 .xlf 文件（不是 .resx 文件）进行翻译，因为 .xlf 文件将生成/更新.resx 文件。

（.xlf 文件应使用“多语言编辑器”打开，如果不是这种情况，请右键单击 .xlf 文件，选择“打开方式...”，然后选择“多语言编辑器”。

玩得开心！现在您也可以查看尚未翻译的内容、将 xlf 中的翻译导出到外部翻译公司、再次导入、回收其他项目的翻译等...

更多信息：

• 使用多语言应用程序工具包 4.0：
  https://learn.microsoft.com/windows/uwp/design/ globalizing/use-mat
• 多语言应用程序工具包博客，请访问：
  http://aka.ms/matblog
• 多语言应用工具包用户语音功能投票站点，请访问：
  http://aka.ms/matvoice

Answer 7

就我而言

[assembly: System.Resources.NeutralResourcesLanguage("ru-RU")]

，AssemblyInfo.cs 阻止了一切正常工作。

Answer 8

除了@Eric Bole-Feysot 的回答之外：

由于卫星程序集，可以基于 .dll/.exe 文件创建本地化。 这样：

• 源代码（VS项目）可以与语言项目分离，
• 添加新语言不需要重新编译项目，
• 甚至可以由最终用户进行翻译。

有一个鲜为人知的工具，名为LSACreator（免费用于非商业用途或购买选项），它允许您可以根据 .dll/.exe 文件创建本地化。 事实上，它在内部（在语言项目的目录中）创建/管理 resx 文件的本地化版本，并以与 @Eric Bole-Feysot 描述的类似方式编译程序集。

Answer 9

您可以使用 Lexical.Localization ，它允许嵌入默认值和文化特定值到代码中，并在外部本地化文件中扩展以获得更多文化（例如 .json 或 .resx）。

public class MyClass
{
    /// <summary>
    /// Localization root for this class.
    /// </summary>
    static ILine localization = LineRoot.Global.Type<MyClass>();

    /// <summary>
    /// Localization key "Ok" with a default string, and couple of inlined strings for two cultures.
    /// </summary>
    static ILine ok = localization.Key("Success")
            .Text("Success")
            .fi("Onnistui")
            .sv("Det funkar");

    /// <summary>
    /// Localization key "Error" with a default string, and couple of inlined ones for two cultures.
    /// </summary>
    static ILine error = localization.Key("Error")
            .Format("Error (Code=0x{0:X8})")
            .fi("Virhe (Koodi=0x{0:X8})")
            .sv("Sönder (Kod=0x{0:X8})");

    public void DoOk()
    {
        Console.WriteLine( ok );
    }

    public void DoError()
    {
        Console.WriteLine( error.Value(0x100) );
    }
}