Бөлісу құралы:

Winres.exe (редактор локализации ресурсов Windows)

Редактор локализации ресурсов Windows Winres.exe— это средство визуального макета, которое помогает специалистам по локализации локализовать ресурсы пользовательского интерфейса Windows Forms, используемые формами. Вы можете создать файлы RESX или .resources , которые используются в качестве входных данных для Winres.exe с помощью визуальной среды разработки, например Microsoft Visual Studio. Сведения о развертывании ресурсов в приложениях .NET Framework см. в разделе "Ресурсы" в приложениях .NET.

Winres.exe устанавливается в Visual Studio. Чтобы запустить средство, используйте командную строку разработчика Visual Studio или Visual Studio Developer PowerShell.

Предупреждение

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

Синтаксис

winres resourceFile
winres /?

Arguments

Аргумент Description
resourceFile Файл ресурса для локализации. Этот файл должен быть файлом resx формы Windows Forms или .resources, созданным конструктором Visual Studio. Winres.exe не удается открыть универсальные RESX-файлы или файлы ресурсов.
Вариант Description
/? Отображает синтаксис команды и параметры средства.

Замечания

Состояние элементов пользовательского интерфейса из формы в проекте Windows Forms обычно хранится в файлах ресурсов, которые являются XML-файлами с расширением RESX или соответствующими скомпилированных двоичных версий с расширением .resources. Winres.exe — это средство, которое позволяет ограничить редактирование любого типа файла за пределами среды разработки Visual Studio. В частности, это позволяет выполнять следующие типы операций редактирования:

  • Нейтральный или конкретный файл ресурсов языка и региональных параметров можно изменить, чтобы изменить свойства пользовательского интерфейса формы или его элементов управления, например текст, размер или положение.
  • Нейтральные или определенные файлы ресурсов языка и региональных параметров можно создать из файла ресурсов по умолчанию.
  • Файл ресурсов языка и региональных параметров можно сохранить в качестве другого файла ресурсов языка и региональных параметров. Например, файл ресурсов английского языка (США) можно сохранить в виде польского файла ресурсов. Обычно новый файл будет изменен для совместимости с новым языком и региональными параметрами.

См. также иерархическую организацию ресурсов для локализации или иерархической организации ресурсов для локализации.

Winres.exe не может преобразовать RESX-файл в соответствующий файл ресурсов; вместо этого используйте средство Resgen.exe. Дополнительные сведения о Resgen.exeсм. в разделе Resgen.exe (генератор файлов ресурсов).

Winres.exe — это графическое приложение, которое воссоздает версию формы Windows Forms во время разработки из только файла ресурсов без доступа к исходному коду. Winres.exe размещает конструктор форм Windows Forms и Properties окно Visual Studio. Эти функции позволяют визуально редактировать ресурсы или RESX-файл, содержащий форму Windows Forms. Как правило, локалиизаторы используют Winres.exe для изменения меток элементов управления и настройки расположения и размера элементов управления для размещения меток для целевого языка и региональных параметров.

Если Winres.exe не удается разрешить тип элемента управления, он создает элемент управления заполнителя в локализованном файле RESX или .resources. Элемент управления заполнителя отображается в форме Windows Forms в виде люка окна. Размер и позиция зашкупленного окна совпадают с размером фактического элемента управления. Все доступные локализованные свойства элемента управления заполнителя отображаются в Properties окне. Все изменения, внесенные в элемент управления заполнителя, сохраняются для фактического элемента управления.

Winres.exe и Visual Studio

Как правило, перед началом локализации форм Windows Forms приложения следует решить, следует ли использовать Visual Studio или Winres.exe в качестве средства локализации. Совместимость версий, как описано далее, может препятствовать переключению одного средства на другое.

Преимущество Visual Studio заключается в том, что его можно использовать как для разработки, так и локализации приложения. Чтобы локализовать форму, после завершения разработки задайте для формы LocalizableAttribute ( Localizable свойство в редакторе Properties ) true и измените его Language свойство на нужный целевой язык и региональные параметры. Затем измените строки и измените расположение и размер элементов управления для размещения строк целевого языка и региональных параметров. При сохранении локализованного RESX-файла Visual Studio записывает в файл только локализованные свойства (свойства, измененные в целевом языке и региональных параметрах). Visual Studio автоматически создает вспомогательную сборку для локализованного RESX-файла в правильном расположении каталога.

Хотя Visual Studio предоставляет интегрированную среду разработки и локализации, Winres.exe рекомендуется использовать, если локализация выполняется сторонними локалиизаторами. Так как Winres.exe — это только средство локализации, оно позволяет более четко разделить код приложения от форм локализации, что более удобно для управления крупными проектами.

Использование Winres.exe

Для локализации с помощью Winres.exeнеобходимо сначала разработать приложение с помощью визуального конструктора, например конструктора Windows Forms в Visual Studio. После завершения разработки задайте для формы LocalizableAttribute ( Localizable свойство в Properties редакторе), trueа затем разверните RESX-файл для языка и региональных параметров по умолчанию стороннему локалиизатору. Этот RESX-файл содержит дополнительные сведения, которые Winres.exe используются для повторного создания версии исходной формы во время разработки.

Замечание

Winres.exe нельзя использовать для изменения файла ресурсов по умолчанию. Winres.exe интерпретирует все измененные свойства как локализованные свойства и сохраняет их в целевом файле ресурсов языка и региональных параметров.

Окончательные версии файлов ресурсов языка и региональных параметров, наконец, можно использовать для создания локализованных версий приложения. Дополнительные сведения см. в разделе "Ресурсы" в приложениях .NET.

Winres.exe имеет следующие функции и возможности:

  • Winres может работать в одном файловом режиме (SFM) или в режиме файлов Visual Studio (VSFM). SFM — это устаревший режим, в котором полные сведения о форме и его содержимое хранятся в файле ресурсов. VSFM сохраняет только культурные изменения в файле ресурсов.

  • Окно отчетов об ошибках, закрепленное в левом нижнем углу главного окна.

  • Горячие ключи можно проверить на наличие дубликатов: в Format меню щелкните команду Check HotKeys .

Совместимость версий

Следует использовать версию Winres.exe, выпущенную с помощью платформы .NET Framework, которую вы используете. В следующей таблице перечислены совместимые версии:

Visual Studio Платформа .NET Framework Winres.exe
Visual Studio .NET 2002 1.0 1.0
Visual Studio .NET 2003 1.1 1.1
Visual Studio 2005 2.0 2.0
Visual Studio 2008 3.0 и 3.5 3.0 и 3.5
Visual Studio 2010 4.0 4.0
Visual Studio 2017 4,6 4,6

Замечание

Хотя VSFM имеет преимущество совместимости с Visual Studio, так как он сохраняет только измененные значения в файле ресурса, Winres.exe требует, чтобы родители текущего файла ресурсов находились в том же каталоге. Например, для редактирования TestApp.de-DE.resourcesфайла ресурсов германии в Германии требуется наличие файла ресурсов по умолчанию иTestApp.resx, возможно, файла ресурса, нейтрального языка и региональных параметров. TestApp.de.resources

Примеры

Локализация RESX-файла или файла ресурсов, связанного с формой

  1. Чтобы запустить Winres.exe, введите winres в командной строке разработчика.

  2. Чтобы открыть ресурсы по умолчанию для локализуемой формы, выберите "Открыть файл>" и перейдите к файлу, чтобы открыть его.

    –или–

    Укажите файл, который нужно открыть в командной строке при запуске Winres.exe. Следующая команда запускает Winres.exe и загружает форму, связанную с TestApp.resx конструктором форм.

    winres TestApp.resx

    Следующая команда запускает Winres.exe и загружает форму, связанную с TestApp.resources конструктором форм.

    winres TestApp.resources

    Замечание

    Если форма, ресурсы которой вы редактируете, является наследуемой формой, сборка содержит унаследованную форму и сборку, содержащую наследуемую (производную) форму, должна быть зарегистрирована в глобальном кэше сборок (GAC), или должна находиться в том же каталоге, что и WinRes.exe. Дополнительные сведения об установке компонентов .NET Framework в GAC см. в глобальном кэше сборок.

  3. Выберите элементы управления в форме и измените их Text и другие свойства, чтобы отразить локализованные региональные параметры и его язык. Перемещение или изменение размера элементов управления при необходимости для размещения локализованного текста.

  4. Чтобы сохранить локализованную версию resx или RESOURCES-файла, щелкните значок или нажмите кнопку Save"Сохранить файл>". В средстве отображается окно "Выбор языка и региональных параметров".

  5. Выберите соответствующий язык и региональные параметры и режим файлов, а затем нажмите кнопку "ОК".

    Средство сохраняет файл с помощью соглашения об именовании, которое среда выполнения ожидает для локализованных файлов ресурсов. Например, если вы локализуете TestApp.resources немецкий язык в Германии, средство сохраняет файл как TestApp.de-DE.resources. Если вы локализуете TestApp.resx для немецкого языка в Германии, средство сохраняет файл как TestApp.de-DE.resx. Дополнительные сведения о соглашениях об именовании ресурсов см. в разделе "Пакеты" и "Развертывание ресурсов". Список предопределенных имен языка и региональных параметров, используемых средой выполнения, см. в CultureInfo этом классе.

См. также

  • Last updated on