Практическое руководство. Создание файлов ресурсов для веб-узлов ASP.NET

Статья
10/22/2014

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

Файл ресурсов — это XML-файл, который может содержать строки и другие ресурсы, например, пути к файлам изображений. Файлы ресурсов обычно используются для хранения строк интерфейса пользователя, которые предполагается переводить на другие языки. Причиной тому служит то, что для каждого языка, на который требуется перевести веб-страницу, можно создать отдельный файл ресурсов.

Глобальные файлы ресурсов доступны всех страницам и компонентам на веб-узле. Локальные файлы ресурсов связываются с отдельной веб-страницей, пользовательским элементом управления или главной страницей, и содержат ресурсы, относящиеся только к этой странице. Дополнительные сведения см. в разделе Общие сведения о ресурсах страниц ASP.NET.

В Visual Web Developer для создания глобальных и локальных файлов ресурсов можно использовать редактор управляемых ресурсов. Для локальных файлов ресурсов также можно создать нейтральный с точки зрения языка и региональных параметров файл ресурсов непосредственно на основе веб-страницы в конструкторе.

Создание ресурсов вручную

Создание ресурса вручную

Убедитесь, что на веб-узле есть каталог, в котором должен храниться файл ресурсов, выполнив одно из следующих действий:
- Если создается глобальный файл ресурсов, то должна присутствовать папка с именем App_GlobalResources. Чтобы создать папку, в обозревателе решений щелкните правой кнопкой мыши имя веб-узла, выберите команду Добавить папку и выберите пункт Папка App_GlobalResources. В приложении может быть только одна такая папка, и располагаться она должна в корневом каталоге приложения.
- Если создается локальный файл ресурсов, то должна присутствовать папка с именем App_LocalResources. Чтобы создать папку, в обозревателе решений щелкните правой кнопкой мыши имя веб-узла, выберите команду Добавить папку и выберите пункт Папка App_LocalResources. В приложении может быть несколько таких папок, и располагаться они могут на любом уровне приложения.

Чтобы создать файл ресурсов, щелкните правой кнопкой мыши папку App_GlobalResources или App_LocalResources и выберите команду Добавить новый элемент.

Примечание.
Глобальные файлы ресурсов должны располагаться в папке App_GlobalResources. При попытке создания файла RESX вне этой папки Visual Web Developer предложит создать файл в этой папке.

В диалоговом окне Добавление нового элемента в разделе Установленные шаблоны Visual Studio выберите Файл ресурсов сборки.
В поле Имя введите имя файла ресурсов и нажмите кнопку Добавить.

Файл будет открыт Visual Web Developer в редакторе управляемых ресурсов. Редактор отображает сетку, в которой можно вводить имена (ключи), значения и необязательные комментарии.

Введите ключевые имена и значения для всех ресурсов, необходимых в приложении, и сохраните файл.

Примечание.
Не пытайтесь внедрять изображения непосредственно в файл ресурсов, поскольку элементы управления не будут воспринимать строку ресурса в качестве потокового файла изображения. Файлы ресурсов представляют изображения путем хранения URL-адреса изображений в строковой форме.

Не пытайтесь внедрять изображения непосредственно в файл ресурсов, поскольку элементы управления не будут воспринимать строку ресурса в качестве потокового файла изображения. Файлы ресурсов представляют изображения путем хранения URL-адреса изображений в строковой форме.

Для создания файлов ресурсов для дополнительных языков скопируйте файл в обозревателе решений или проводнике Windows и переименуйте его, используя один из следующих образцов:
- Для глобальных файлов ресурсов:
  
  имя.язык.resx
  
  имя.язык-культура.resx
- Для локальных файлов ресурсов:
  
  имя_страницы_или_элемента_управления.расширение.язык.resx
  
  имя_страницы_или_элемента_управления.расширение.язык-культура.resx
Так, если создается глобальный файл ресурсов с именем WebResources.resx для перевода на египетский диалект арабского языка, скопированному файлу следует дать имя WebResources.ar-eg.resx. Для создания связанного файла ресурсов для перевода на испанский язык без указания конкретных региональных параметров скопированному файлу следует дать имя WebResources.es.resx. Обратите внимание, что для локальных файлов ресурсов имя файла ресурса включает имя страницы или элемента управления вместе с расширением имени файла, за которым следует указание языка и региональных параметров.
Откройте скопированный файл и переведите все значения, не изменяя имен (ключей).
Повторите шаги 6-7 для каждого дополнительного языка, который необходимо использовать.

Создание ресурсов по веб-странице

Следующая функция недоступна в Visual Web Developer, экспресс-выпуск.

Создание локального файла ресурсов по веб-странице ASP.NET

Откройте страницу, по которой нужно создать файл ресурсов.
Перейдите в представление конструирования.
В меню Сервис выберите команду Создать локальный ресурс.

Visual Web Developer создаст папку App_LocalResources, если она еще не создана. После этого Visual Web Developer создает для текущей страницы базовый файл ресурсов, независимый от языковых и региональных параметров, содержащий пару "ключ-имя" для каждого свойства элемента управления или страницы, для которого требуется локализация. Наконец, Visual Web Developer добавляет атрибут meta ко всем серверным веб-элементам управления ASP.NET для того, чтобы настроить элементы на неявную локализацию. Дополнительные сведения о явной и неявной локализации см. в разделах Общие сведения о ресурсах страниц ASP.NET и Практическое руководство. Использование ресурсов для установки значений свойств в серверных веб-элементах управления.

Введите значения для всех ресурсов, необходимых в приложении, после чего сохраните файл.

Если последние изменения ресурсов не отображаются, обновите представление конструктора путем перехода в режим исходного кода и обратно.
Создайте файлы ресурсов для дополнительных языков, повторив шаги 6–7 из предыдущей процедуры.

Примечание.
Не пытайтесь внедрять изображения непосредственно в файл ресурсов, поскольку элементы управления не будут воспринимать строку ресурса в качестве потокового файла изображения. Файлы ресурсов представляют изображения путем хранения URL-адреса изображений в строковой форме.

Создание глобального файла ресурсов в Visual Web Developer

В обозревателе решений щелкните правой кнопкой мыши имя веб-узла, выберите команду Добавление нового элемента и Файл ресурсов.

Visual Web Developer выдаст запрос на размещение файла в папке App_GlobalResources и предложит создать эту папку.
Нажмите кнопку Да.

Введите значения для всех ресурсов, необходимых в приложении, после чего сохраните файл.

Если последние изменения ресурсов не отображаются, обновите представление конструирования путем перехода в режим исходного кода и обратно.

Примечание.
Не пытайтесь внедрять изображения непосредственно в файл ресурсов, поскольку элементы управления не будут воспринимать строку ресурса в качестве потокового файла изображения. Файлы ресурсов представляют изображения путем хранения URL-адреса изображений в строковой форме.

Для создания файлов ресурсов для дополнительных языков скопируйте файл в обозревателе решений или проводнике Windows и переименуйте его, используя один из следующих образцов:

имя.язык.resx

имя.язык-культура.resx

Примечание.
При именовании файлов ресурсов не следует включать в имя расширение .aspx, поскольку это может привести к конфликту имен. Например, в папке Resource не могут одновременно находиться два файла с именами наподобие resTestPage.resx и resTestPage.aspx.resx. В этом случае разрешение имен файлов во время компиляции приведет к конфликту имен, что, в свою очередь, вызовет ошибку во время компиляции.

При именовании файлов ресурсов не следует включать в имя расширение .aspx, поскольку это может привести к конфликту имен. Например, в папке Resource не могут одновременно находиться два файла с именами наподобие resTestPage.resx и resTestPage.aspx.resx. В этом случае разрешение имен файлов во время компиляции приведет к конфликту имен, что, в свою очередь, вызовет ошибку во время компиляции.