共用方式為

文字檔格式的資源

  • 發行項

更新：2007 年 11 月

文字 (.txt) 檔只能包含字串資源。只要正確地儲存文字檔，就可使用三種編碼配置中的任何一個指定字串：位元組由小到大或位元組由大到小之位元組順序的 UTF-16 或 UTF-8。例如，如果您想要儲存並使用德文字元，就應使用 UTF-8 編碼而不是特定的 ANSI 字碼頁 (Code Page) 儲存文字檔。如需使用編碼的詳細資訊，請參閱 .NET Framework 中的 Unicode。

注意事項：

根據預設，資源檔產生器 (Resgen.exe) 會將檔案視為 UTF-8。若要讓 Resgen.exe 能辨認使用 UTF-16 編碼的檔案，請務必在檔案開頭處加入 Unicode 位元組順序標記 (U+FEFF)。

除了字串項目之外，文字檔還可以包含註解。您可以包括在文字檔內的項目數並沒有限制。您也可以在檔案中全面使用泛空白字元 (空白行)，使它易於閱讀。您應該注意，周圍的空格並不包括在所儲存或擷取的各行之內。此外，允許使用空白字串。

如果文字檔包含重複的資源名稱，則 Resgen.exe 將會發出警告，並忽略重複的名稱。

下表描述文字檔的項目類型。

項目

說明

;comments

您可以選擇性地將註解包含在文字檔各處。註解的前置詞必須是分號或井字符號 (#)。註解可以幫助說明資源是如何組織的。例如，您可能在特定檔案中以註解 (例如 ;exceptions、;general messages、;text labels、;form titles 等等) 標記您的資源來組織它們。注意，這些註解在您轉換 .txt 檔為 .resources 檔時會遺失。

name = value

您必須將字串資源指定為名稱/值組項目，其中名稱為描述資源的字串，而值則為 ResourceManager.GetString 方法擷取名稱時，將會傳回的資源字串。名稱和值必須以等號 (=) 分隔。例如，Msg1 = Hello, and Welcome!。該值無法包含新行字元，但您可以使用如 \n 的 C 程式語言之逸出字元 (Escape Character) 代表新行，並以 \t 來代表索引標籤。此外也允許空字串。例如：MyEmptyString=.

一旦將所需的項目加入文字檔之後，便可以適當的名稱和 .txt 副檔名加以儲存。

注意事項：

請不要使用資源檔來存放密碼、安全性敏感的資訊或私人資料。

不能在組件中內嵌 .txt 檔。您必須使用資源檔產生器 (Resgen.exe)，轉換您的 .txt 檔成為 .resources 檔。如需詳細資訊，請參閱 .Resources 檔案格式的資源。

請參閱

概念

建立資源檔

.Resources 檔案格式的資源

參考

資源檔產生器 (Resgen.exe)