Ресурсы в формате текстового файла
Обновлен: Ноябрь 2007
Текстовый файл (.txt) может содержать только строковые ресурсы. При сохранении текстового файла строки указываются с помощью одной из трех схем кодировки: UTF-16 с прямым порядком следования байтов, UTF-16 с обратным порядком байтов или UTF-8. Например, если требуется сохранить и использовать немецкие буквы, следует сохранить текстовый файл, используя кодировку UTF-8 вместо конкретной кодовой страницы ANSI. Дополнительные сведения об использовании кодировок см. в разделе Юникод в .NET Framework.
.gif "Примечание") Примечание. |
|---|
В генераторе файлов ресурсов (Resgen.exe) по умолчанию файлы считаются сохраненными в формате UTF-8. Чтобы программа Resgen.exe могла работать с файлом в кодировке UTF-16, необходимо в начало файла включить маркер порядка следования байтов Юникода (U+FEFF). |
Кроме строковых записей, текстовые файлы могут содержать комментарии. Количество включаемых в текстовый файл записей неограниченно. Для удобства чтения в файл можно вставлять пробелы (пустые строки). Обратите внимание, что стоящие в начале и конце каждой строки пробелы не включаются в эту строку, когда она сохраняется или извлекается. Разрешается использование пустых строк.
Если в текстовом файле содержатся совпадающие имена ресурсов, Resgen.exe выведет предупреждение и пропустит совпадающие имена.
В следующей таблице приводится описание типов записей в текстовых файлах.
Запись |
Описание |
|---|---|
;комментарии |
Комментарии можно включать в любое место текстового файла. Комментарий должен предваряться точкой с запятой или знаком номера (#). С помощью комментариев можно разъяснять, как организованы ресурсы. Например, можно разместить ресурсы в файле, снабдив их такими комментариями: ";исключения", ";общие сообщения", ";метки в тексте", ";заголовки форм" и т. д. Обратите внимание, что при преобразовании файла из формата .txt в формат .resources комментарии теряются. |
имя = значение |
Строковые ресурсы должны быть организованы в виде пар "имя-значение", где имя — это строка, которая описывает ресурс, а значение — строка ресурса, которая возвращается при извлечении имени с помощью метода ResourceManager.GetString. Имя и значение должны быть разделены знаком равенства (=). Например, Msg1 = Hello, and Welcome! Значение не может содержать знаки начала новой строки, однако можно пользоваться escape-знаками языка С, такими как \n (для обозначения новой строки) и \t (для обозначения позиции табуляции). Разрешается использование пустых строк. Например: MyEmptyString=. |
Включив в текстовый файл все необходимые данные, его следует сохранить с подходящим именем и расширением .txt.
| Примечание. |
|---|
Не следует использовать файлы ресурсов для хранения паролей, секретных сведений или личных данных. |
Файл .txt нельзя включать в сборку. Файл .txt необходимо преобразовать в файл .resources с помощью генератора файлов ресурсов (Resgen.exe). Дополнительные сведения содержатся в разделе Ресурсы в файле формата .Resources.
См. также
Основные понятия
Ресурсы в файле формата .Resources