Управление ресурсами приложения

2025-06-12

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

Осторожность

Ресурсы в файлах .resx могут быть сериализованы с помощью BinaryFormatter, что незащищено. Включите только те .resx файлы в процесс сборки, которым вы доверяете.

Дополнительные сведения о ресурсах в приложениях .NET см. в разделе "Ресурсы" в приложениях .NET.

Работа с ресурсами

В проекте управляемого кода откройте окно свойств проекта. Окно свойств можно открыть следующими способами:

Щелкните правой кнопкой мыши узел проекта в обозревателе решений и выберите свойства
Ввод свойств проекта в поле поиска CTRL+Q
Нажатие Alt++ в Обозревателе решений

Перейдите на вкладку "Ресурсы ". Можно добавить RESX-файл , если проект еще не содержит один, добавить и удалить различные виды ресурсов и изменить существующие ресурсы.

Улучшения обозревателя ресурсов в Visual Studio 2022 и более поздних версиях

Начиная с Visual Studio 2022 версии 17.11 обозреватель ресурсов значительно улучшен. Ознакомьтесь с обновленным обозревателем ресурсов Visual Studio.

Чтобы использовать новый обозреватель ресурсов, необходимо иметь проект .NET, содержащий один или несколько файлов ресурсов (.resx). Чтобы открыть обозреватель ресурсов, щелкните правой кнопкой мыши любой файл ресурсов в обозревателе решений и выберите "Открыть с помощью>обозревателя ресурсов". Кроме того, можно использовать сочетание клавиш CTRL+ALT+R.

Когда вы открываете новый обозреватель ресурсов, слева вы увидите обзор всех сохранённых вами ресурсов вместе с локализациями для каждого файла. Вы можете настроить видимость локалей в таблице данных. Этот интерфейс позволяет сравнивать переводы параллельно и изменять их на месте.

Поиск строк ресурсов

В левом верхнем углу сетки можно использовать поле поиска, чтобы выполнить текстовый поиск по всем ресурсным файлам. Чтобы найти ресурс, введите поле поиска на панели инструментов и нажмите клавишу ВВОД. В сетке данных отображаются только те ресурсы, которые соответствуют вашему запросу в имени, значении или комментарии. Подстановочные знаки (*) можно использовать для выполнения частичных совпадений, а кавычки (") — для точных совпадений.

Добавление комментариев к определенным переводам ресурса

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

Чтобы добавить комментарий к ресурсу, выберите ячейку, соответствующую переводу, которую нужно закомментировать, и нажмите кнопку "Изменить комментарий " на панели инструментов или нажмите клавишу SHIFT+ВВОД. Поле комментария отображается под ячейкой, где можно ввести комментарий. Нажмите клавишу ВВОД , чтобы сохранить комментарий или ESC , чтобы отменить его.

Вы можете изменить или удалить существующие комментарии, щелкнув поле комментария или используя то же сочетание клавиш. Чтобы просмотреть все комментарии для ресурса, найдите небольшой значок треугольника в углу каждой ячейки с комментарием. Вы можете навести указатель мыши на значок, чтобы увидеть подсказку с текстом комментария или щелкнуть его, чтобы открыть поле комментариев.

Комментарии доступны нескольким пользователям файлов ресурсов. Переводчик, разработчик или диспетчер ресурсов может оставлять заметки, вопросы, объяснения или предостережения наряду с переводами. Небольшой значок в углу каждой ячейки указывает на наличие комментария.

Фильтрация ресурсов

Чтобы отфильтровать ресурсы, щелкните значок фильтра на панели инструментов и выберите критерии, которые нужно применить. Ресурсы можно фильтровать по имени, значению, комментариев, типу или файлу.

Фильтр	Описание
Имя	Показывать только ресурсы с определенным именем или префиксом.
Ценность	Показывать только ресурсы, имеющие определенное значение или содержащие определенную строку.
Комментарий	Показывать только ресурсы, содержащие комментарий или содержащие определенную строку в своем комментарии.
Тип	Отображение только ресурсов с определенным типом, например строкой, изображением или значком.
Файл	Показывать только ресурсы, принадлежащие определенному файлу или культуре.

Вы можете объединить несколько фильтров, чтобы сузить результаты и очистить их, нажав кнопку "Очистить фильтр".

Проверка и предупреждения

Заполнители — это специальные маркеры, которые заменяются динамическими значениями во время выполнения, например {0}, {1}или {name}. Если вы используете плейсхолдеры в своих ресурсах, необходимо убедиться, что они согласованы во всех локализациях, иначе в приложении могут возникнуть ошибки или неожиданное поведение.

Новый обозреватель ресурсов автоматически проверяет заполнители для каждого ресурса и отображает значок предупреждения, если имеется несоответствие между параметрами культуры по умолчанию и любой другой локализацией. Например, если значение по умолчанию ресурса — "Привет, {name}!" и испанское значение — "Hola, {nombre}!", появится значок предупреждения, указывающий, что имя заполнителя отличается. Вы можете навести указатель мыши на значок, чтобы увидеть подсказку с подробными сведениями о несоответствии и щелкнуть ее, чтобы исправить ее.

Отсутствующие переводы являются еще одной распространенной проблемой, которая может повлиять на взаимодействие с пользователем приложения. Если вы не предоставляете перевод ресурса в определенной культуре, приложение вернется к культуре по умолчанию, что может оказаться неподходящим или нежелательным для некоторых пользователей. Обозреватель ресурсов помогает избежать этой проблемы, показывая значок предупреждения, если в определенной культуре нет значения для ресурса. Например, если> у вас есть ресурс со значением File по умолчанию, но отсутствует значение для французского языка и культуры, появится значок предупреждения, показывающий, что перевод отсутствует. Вы можете навести указатель мыши на значок, чтобы увидеть подсказку с сообщением No value и выбрать его, чтобы добавить значение.

Параметры настройки

Обозреватель ресурсов в Visual Studio 2022 и более поздних версиях совместим с средствами чтения с экрана и вспомогательными технологиями, чтобы сделать его более доступным для разработчиков с нарушениями зрения или ограниченными возможностями. Сочетания клавиш можно использовать для навигации по сетке данных, редактированию значений и комментариев и выполнению общих действий. Вы также можете использовать экранного диктора для считывания содержимого каждой ячейки, а также всплывающих подсказок и предупреждений.

Чтобы настроить уровень масштабирования, используйте ползунок масштабирования на панели инструментов или сочетания клавиш CTRL+= и CTRL+-, чтобы увеличить или вывести. Используйте ctrl+0 , чтобы сбросить уровень масштабирования по умолчанию.

Тема обозревателя ресурсов соответствует остальной части среды Visual Studio. Вы можете выбрать между светлыми, темными или синими темами, а обозреватель ресурсов будет адаптироваться соответствующим образом. Вы также можете изменить шрифт и цвета сетки данных с помощью диалогового окна"Параметры>среды>инструментов>"и "Цвета".

Ресурсы в других типах проектов

Ресурсы управляются по-разному в проектах .NET, чем в других типах проектов. Дополнительные сведения о ресурсах см. в:

Приложения универсальной платформы Windows (UWP) см. в статьях "Ресурсы приложений" и "Система управления ресурсами"
Проекты C++/CLI (управляемые) см. в статьях "Ресурсы" в классических приложениях
Проекты C++ см. в статье "Работа с файлами ресурсов" и "Практическое руководство. Создание ресурса"
- Используйте окно Представление ресурсов (Вид>Другие окна>Представление ресурсов) для отображения файлов ресурсов, включенных в проекты.

Варианты поддержки

Если возникла проблема с управлением ресурсами приложения, см. статью "Устранение ошибок" в редакторе ресурсов.