Ресурсы в формате текстового файла

Обновлен: Ноябрь 2007

Текстовый файл (.txt) может содержать только строковые ресурсы. При сохранении текстового файла строки указываются с помощью одной из трех схем кодировки: UTF-16 с прямым порядком следования байтов, UTF-16 с обратным порядком байтов или UTF-8. Например, если требуется сохранить и использовать немецкие буквы, следует сохранить текстовый файл, используя кодировку UTF-8 вместо конкретной кодовой страницы ANSI. Дополнительные сведения об использовании кодировок см. в разделе Юникод в .NET Framework.

Примечание.
В генераторе файлов ресурсов (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

Ссылки

Генератор файлов ресурсов (Resgen.exe)