Winres.exe (Editor de Localização de Recursos do Windows)

O Editor de Localização de Recursos do Windows, Winres.exe, é uma ferramenta de layout visual que ajuda especialistas em localização a localizar recursos de interface do usuário do Windows Forms usados pelos formulários. Você pode criar os arquivos .resx ou .resources que são usados como entrada para Winres.exe usando um ambiente de design visual, como o Microsoft Visual Studio. Para obter informações sobre como implantar recursos em aplicativos do .NET Framework, consulte Recursos em aplicativos .NET.

Winres.exe é instalado com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Desenvolvedor do Visual Studio.

Sintaxe

winres resourceFile
winres /?

Arguments

Observações

O estado dos elementos de interface do usuário de um formulário em um projeto do Windows Forms normalmente é armazenado em arquivos de recurso, que são arquivos baseados em XML com a extensão .resx ou as versões binárias compiladas correspondentes com a extensão .resources. Winres.exe é uma ferramenta que permite a edição limitada de qualquer tipo de arquivo fora do ambiente de design do Visual Studio. Especificamente, ele permite os seguintes tipos de operações de edição:

• Um arquivo de recurso de cultura neutro ou específico pode ser editado para alterar as propriedades da interface do usuário do formulário ou seus controles, como texto, tamanho ou posição.
• Arquivos de recurso de cultura neutros ou específicos podem ser gerados do arquivo de recurso padrão.
• Um arquivo de recurso de cultura pode ser salvo como outro arquivo de recurso de cultura. Por exemplo, um arquivo de recurso inglês (EUA) pode ser salvo como um arquivo de recurso polonês. Normalmente, o novo arquivo seria posteriormente editado para ser compatível com a nova cultura.

Consulte também a Organização Hierárquica de Recursos para Localização ou Organização Hierárquica de Recursos para Localização.

Winres.exe não pode converter um arquivo .resx em seu arquivo .resources correspondente; em vez disso, use a ferramenta Resgen.exe. Para obter mais informações sobre Resgen.exe, consulte Resgen.exe (Gerador de Arquivos de Recurso).

Winres.exe é um aplicativo gráfico que recria uma versão em tempo de design de um formulário do Windows Forms apenas do arquivo de recurso, sem ter acesso ao código-fonte. Winres.exe hospeda o Designer de Formulários do Windows Forms do Visual Studio e Properties a janela. Esses recursos permitem a edição visual de um arquivo .resources ou .resx que contém um formulário do Windows Forms. Normalmente, os localizadores usam Winres.exe para editar rótulos de controle e ajustar o local e o tamanho dos controles para acomodar os rótulos da cultura de destino.

Se Winres.exe não puder resolver o tipo de controle, ele criará um controle de espaço reservado no arquivo .resx ou .resources localizado. O controle de espaço reservado é exibido no formulário do Windows Forms como uma janela eclodida. O tamanho e a posição da janela eclodida correspondem ao do controle real. Todas as propriedades localizáveis disponíveis para o controle de espaço reservado aparecem na Properties janela. Todas as alterações feitas no controle de espaço reservado são salvas para o controle real.

Winres.exe versus Visual Studio

Em geral, antes de começar a localizar os formulários do Windows Forms de um aplicativo, você deve decidir se deseja usar o Visual Studio ou Winres.exe como a ferramenta de localização. A compatibilidade de versão, conforme descrito posteriormente, pode impedir a alternância de uma ferramenta para a outra.

A vantagem do Visual Studio é que você pode usá-lo para desenvolver e localizar um aplicativo. Para localizar um formulário, após a conclusão do LocalizableAttribute desenvolvimento, defina o formulário (a Localizable propriedade no Properties editor) true e altere sua Language propriedade para a cultura de destino desejada. Em seguida, edite cadeias de caracteres e ajuste o local e o tamanho dos controles para acomodar as cadeias de caracteres para a cultura de destino. Quando você salva o arquivo .resx localizado, o Visual Studio grava apenas as propriedades localizáveis (propriedades que foram alteradas na cultura de destino) no arquivo. O Visual Studio cria automaticamente um assembly satélite para o arquivo .resx localizado no local correto do diretório.

Embora o Visual Studio forneça um ambiente integrado de desenvolvimento e localização, Winres.exe é a ferramenta recomendada a ser usada se a localização for feita por localizadores de terceiros. Como Winres.exe é apenas uma ferramenta de localização, ela permite que uma separação mais limpa do código de um aplicativo dos formulários seja localizada, o que é mais prático para gerenciar projetos grandes.

Usando Winres.exe

Para localizar usando Winres.exe, primeiro você deve desenvolver um aplicativo usando um designer visual como o Designer de Formulários do Windows no Visual Studio. Quando o desenvolvimento for concluído, defina o formulário LocalizableAttribute (a Localizable propriedade no editor) como truee, em Properties seguida, entregue o arquivo .resx da cultura padrão para um localizador de terceiros. Este arquivo .resx contém informações extras que Winres.exe usa para recriar uma versão em tempo de design do formulário original.

As versões finais dos arquivos de recurso de cultura podem finalmente ser usadas para criar versões localizadas do aplicativo. Para obter mais informações, consulte Recursos em aplicativos .NET.

Winres.exe tem os seguintes recursos e recursos:

• O Winres pode operar no SFM (Modo de Arquivo Único) ou no VSFM (Modo de Arquivo do Visual Studio). SFM é o modo herdado em que informações completas sobre o formulário e seu conteúdo são armazenadas no arquivo de recurso. O VSFM armazena apenas as alterações culturais no arquivo de recurso.

• Uma janela de relatório de erros, encaixada na parte inferior esquerda da janela principal.

• As teclas de acesso podem ser verificadas quanto a duplicatas: no Format menu, clique no comando Verificar HotKeys .

Compatibilidade entre versões

Você deve usar a versão de Winres.exe que foi lançada com o .NET Framework que você está usando. A tabela a seguir lista as versões compatíveis:

Exemplos

Para localizar um arquivo .resx ou .resources associado a um formulário

1. Para executar Winres.exe, insira winres o prompt de comando do desenvolvedor.

2. Para abrir os recursos padrão de um formulário para localizar, selecione Abrir Arquivo > e navegue até o arquivo para abri-lo.

   - ou -

   Especifique o arquivo a ser aberto na linha de comando quando você iniciar Winres.exe. O comando a seguir inicia Winres.exe e carrega o formulário associado TestApp.resx ao Designer de Formulários.

   winres TestApp.resx
   

   O comando a seguir inicia Winres.exe e carrega o formulário associado TestApp.resources ao Designer de Formulários.

   winres TestApp.resources
   

   Observação

   Se o formulário cujos recursos você está editando for um formulário herdado, o assembly contém o formulário herdado e o assembly que contém o formulário herdado (derivado) deve ser registrado no GAC (Cache de Assembly Global) ou deve residir no mesmo diretório que WinRes.exe. Para obter mais informações sobre como instalar componentes do .NET Framework no GAC, consulte o Cache de Assembly Global.

3. Selecione controles no formulário e altere suas Text e outras propriedades para refletir a cultura localizada e sua linguagem. Mova ou redimensione os controles conforme necessário para acomodar o texto localizado.

4. Para salvar a versão localizada do arquivo .resx ou .resources, clique no Save ícone ou selecione Salvar Arquivo>. A ferramenta exibe a janela Selecionar Cultura .

5. Selecione a cultura e o modo de arquivo apropriados e clique em OK.

   A ferramenta salva o arquivo usando a convenção de nomenclatura que o runtime espera para arquivos de recursos localizados. Por exemplo, se você localizar TestApp.resources alemão na Alemanha, a ferramenta salvará o arquivo como TestApp.de-DE.resources. Se você localizar TestApp.resx alemão na Alemanha, a ferramenta salvará o arquivo como TestApp.de-DE.resx. Para obter mais informações sobre convenções de nomenclatura de recursos, consulte Empacotar e Implantar recursos. Para obter uma lista dos nomes de cultura predefinidos usados pelo runtime, consulte a CultureInfo classe.

Consulte também

• LocalizableAttribute
• CultureInfo
• ResourceManager
• ResourceReader
• ResourceWriter
• Ferramentas
• Recursos em aplicativos .NET
• Globalização e localização