文本文件格式中的资源

更新:2007 年 11 月

文本 (.txt) 文件只能包含字符串资源。只要正确地保存文本文件,您就可以指定采用三种编码方案之一的字符串:little-endian 或 big-endian 字节顺序的 UTF-16,或者 UTF-8。例如,如果要保存和使用德语字符,请使用 UTF-8 编码(而不是使用特定的 ANSI 代码页)保存文本文件。有关使用编码的更多信息,请参见 .NET Framework 中的 Unicode

说明:

资源文件生成器 (Resgen.exe) 在默认情况下使用 UTF-8 编码来处理文件。若要让 Resgen.exe 识别使用 UTF-16 编码的文件,必须在该文件的开头包含 Unicode 字节顺序标记 (U+FEFF)。

除了字符串项之外,文本文件还可以包含注释。对于在文本文件中可以包括的项的数目没有限制。您还可以在文件中使用空白(空行),以增强文件的可读性。您应该注意,当存储和检索单独的行时,该行周围的空白并不与该行一起存储或检索。此外,允许使用空字符串。

如果文本文件包含重复的资源名,Resgen.exe 将发出警告,并忽略重复的名称。

下表说明了文本文件的项类型。

说明

;comments

您可以选择在文本文件中是否包括注释。您必须在注释前添加分号或数字符号 (#) 前缀。注释可以帮助您说明组织资源的方式。例如,您可以通过用注释标注资源来组织特定文件中的资源,如:;异常、;一般信息、;文本标签、;窗体标题等。请注意,当您将 .txt 文件转换为 .resources 文件时,这些注释将丢失。

name = value

您必须将字符串资源指定为名称/值对项,其中的名称是描述资源的字符串,而值是 ResourceManager.GetString 方法检索该名称时将返回的资源字符串。名称和值必须用等号 (=) 分隔开。例如,Msg1 = Hello, and Welcome! 值不能包含换行符,但您可以使用 C 语言样式的转义符(如使用 \n 来表示新行,使用 \t 来表示制表符)。此外,允许使用空字符串。例如:MyEmptyString=。

当所需的全部项都已添加到文本文件后,用适当的名称和 .txt 扩展名保存该文本文件。

说明:

不要使用资源文件来存储密码、安全敏感信息或保密数据。

不能在程序集中嵌入 .txt 文件。您必须使用资源文件生成器 (Resgen.exe) 将 .txt 文件转换为 .resources 文件。有关更多信息,请参见 .Resources 文件格式中的资源

请参见

概念

创建资源文件

.Resources 文件格式中的资源

参考

资源文件生成器 (Resgen.exe)