Windows Forms recurso Editor (Winres.exe)
O Editor de recursos de Formulários do Windows, Winres.exe, é uma ferramenta de layout visual que ajuda especialistas em localização a localizar (traduzir) a interface do usuário em Formulários do Windows, os recursos usados por formulários. sistema autônomo arquivos .resx ou .Recursos usados sistema autônomo entrada para Winres.exe podem ser criados usando um ambiente de design visual sistema autônomo o Microsoft Visual Studio. Para obter informações sobre como implantar recursos em aplicativos .NET estrutura, consulte Recursos em aplicativos.
winres resourceFile
winres /?
Comentários
Argumento |
Descrição |
|---|---|
resourceFile |
O arquivo de recurso de localizar. Esse arquivo deve ser um arquivo Windows Forms de .resx ou .Recursos formulário gerado pelo designer do Visual Studio. Winres.exe não pode em em aberto arquivos de .resx ou .Recursos genéricos. |
Opção |
Descrição |
|---|---|
/? |
Exibe sintaxe de comando e opções para a ferramenta. |
O estado de elementos da interface do usuário de um formulário em um projeto Windows Forms normalmente são armazenadas em arquivos de recurso, que são um dos arquivos com base em XML com a extensão .resx ou correspondente compilado, versões binárias com o .Recursos de extensão. Winres.exe é uma ferramenta que permite a edição limitada de qualquer tipo de arquivo fora do ambiente de design do Visual Studio. Especificamente, permite que os seguintes tipos de operações de edição:
Um arquivo de recurso da cultura neutra ou específicas pode ser editado para alterar sistema autônomo propriedades de interface do usuário do formulário ou seus controles, sistema autônomo seu texto, dimensionar ou posicionar.
Neutro ou arquivos de recursos da cultura específica podem ser gerados do arquivo de recurso padrão.
Um arquivo de recursos da cultura pode ser salvas sistema autônomo outro arquivo de recurso de cultura. Por exemplo, um arquivo de recursos em inglês (EUA) pode ser salvo sistema autônomo um arquivo de recurso polonês. Normalmente o novo arquivo, em seguida, poderia ser editado para ser compatível com a cultura nova.
Para obter mais informações, consulte Organização hierárquica para localização de recursos e Organização hierárquica para localização de recursos e Organização hierárquica para localização de recursos e Organização hierárquica de recursos para localização.
Winres.exe não é possível converter um arquivo .resx em seu arquivo .Recursos correspondente; use a ferramenta resgen.exe. Para obter mais informações sobre Resgen.exe, consulte Recurso arquivo gerador (Resgen.exe).
Winres.exe é um aplicativo gráfico que recria uma versão de time de design de um formulário do Windows Forms apenas ao arquivo de recurso, sem ter acesso ao código-fonte. janela Propriedades de Windows Forms Designer de formulário e do Winres.exe hosts Visual Studio. 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 usar Winres.exe para edição rótulos de controle e ajustar o local e o dimensionar dos controles para acomodar os rótulos para a cultura de destino.
Se Winres.exe não puder resolver o tipo de um controle, ele cria um controle de espaço reservado no arquivo .Recursos ou .resx localizadas. O controle de espaço reservado será exibido no formulário Windows Forms sistema autônomo uma janela hachurada. O dimensionar e a posição da janela hachurada corresponde do controle real. Todas as propriedades localizáveis disponível para o controle de espaço reservado aparecem na janela Propriedades. As alterações que fizer para o 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 sistema autônomo formulários de Windows Forms do aplicativo, você deve decidir se deseja usar Visual Studio ou Winres.exe sistema autônomo a ferramenta de localização. Compatibilidade de versão, conforme descrito posteriormente, pode impedir você de alternar de uma ferramenta para Outros.
A vantagem do Visual Studio é que você pode usá-lo a desenvolver e localizar um aplicativo. Para localizar um formulário, após a conclusão, desenvolvimento conjunto LocalizableAttribute (o Localizável propriedade no Editor de propriedades) para true e alterar seu linguagem propriedade para a cultura de destino desejado. Em seguida, edição de seqüências de caracteres e ajustar o local e dimensionar dos controles para acomodar as seqüências de caracteres para a cultura de destino. Quando você salva o arquivo .resx localizadas, Visual Studio grava somente as propriedades localizáveis (propriedades alteradas na cultura destino) para o arquivo. O Visual Studio cria automaticamente um asssembly satélite para o arquivo .resx localizadas no local de diretório correto. Para obter mais informações, consulte Demonstra Passo a passo: Localizando do Windows Forms e Demonstra Passo a passo: Localizando do Windows Forms e Demonstra Passo a passo: Localizando do Windows Forms e Demonstra Passo a passo: Localizando Windows Forms e Demonstra Passo a passo: Localizando Windows Forms e Instruções passo a passo: localizando Windows Forms.
Embora o Visual Studio forneça um ambiente de localização e de desenvolvimento integrado, Winres.exe é a ferramenta recomendada para usar se localização será feita pelos localizadores de terceiros. Como Winres.exe é apenas uma ferramenta de localização, ele permite uma separação de limpeza do código do aplicativo de formulários a serem localizados, 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 Forms Designer no Visual Studio. Ao desenvolvimento estiver concluído, defina LocalizableAttribute (o Localizável propriedade no Editor de propriedades) para truee entregar o arquivo .resx para a 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 time de design do formulário original.
Aviso
Winres.exe não pode ser usado para edição o arquivo de recurso padrão. Winres.exe interpreta propriedades alteradas todos sistema autônomo propriedades localizadas e salva-sistema autônomo no arquivo de recurso de cultura de destino.
As versões finais da cultura recurso arquivos finalmente podem ser usados para criar versões localizadas do aplicativo. Para obter mais informações, consulte Recursos em aplicativos.
Versão 2.0 do Winres.exe possui os seguintes recursos:
Winres pode operar em modo de arquivo único (SFM) ou VSFM (Visual Studio File modo). SFM é modo herdado onde obter informações completas sobre o formulário e seu Sumário são armazenadas no arquivo de recurso. VSFM somente armazena somente as alterações culturais no arquivo de recurso.
Uma janela do relatório de erros, encaixada à parte inferior esquerda da janela principal, foi adicionada à interface.
Teclas de atalho podem ser verificadas para duplicatas: no menu Formatar, clicar no Verifique se as teclas de atalhocomando .
Compatibilidade de Versão
Porque o formato dos arquivos de recurso foi alterado entre o Visual Studio .NET 2002 e Visual Studio 2005, Winres.exe da mesma forma foi alterado para ser compatível. Portanto, sistema autônomo regra geral, você deve usar a versão do Winres.exe que foi lançada com o .NET estrutura que você está usando para criar o aplicativo. A tabela a seguir lista as versões compatível.
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 |
Se você tentar em em aberto um arquivo de recurso mais antigo com a versão 2.0 do Winres.exe, você será solicitado a atualizar formato do arquivo para ser compatível com a versão 2.0 do .NET estrutura.
Nas versões do .NET estrutura anteriores à versão 2.0, Winres.exe e o Forms Designer do Visual Studio criadas arquivos de recursos incompatíveis de cultura neutra e específicos de cultura. Portanto, depois que o processo de localização começou, era necessário continuar usando apenas a mesma ferramenta. No entanto, com a versão 2.0 do Winres.exe, o Visual Studio modo de arquivo (VSFM) foi adicionado. sistema autônomo o nome implica, um arquivo de recurso salvo nesse modo de compatibilidade pode ser editado com qualquer uma dessas ferramentas.
.gif "Observação") Observação: |
|---|
Embora VSFM tem a vantagem de ser compatível com o Visual Studio, desde que ele armazena apenas valores no arquivo de recurso alterou, Winres.exe exige que os pais do arquivo de recurso corrente esteja localizado no mesmo diretório. Por exemplo, editando TestApp.de-DE.resources, um alemão da Alemanha arquivo de recurso, exige a presença do arquivo de recurso padrão TestApp.resxe possivelmente o arquivo de recurso de cultura neutra, TestApp.de.resources. |
Exemplos
Para localizar um arquivo .resx ou .Recursos associado a um formulário
Tipo de winres no aviso de comando para executar Winres.exe.
Para em em aberto os recursos padrão para localizar um formulário, clicar no em aberto comando a Arquivo menu e navegar até o arquivo para abri-lo.
- ou -
Especifique o arquivo para em em aberto na linha de comando ao iniciar Winres.exe.
O comando a seguir inicia Winres.exe e carrega o formulário associado a TestApp.resx no projeto do formulário.
winres TestApp.resxO comando a seguir inicia Winres.exe e carrega o formulário associado a TestApp.resources no projeto do formulário.
winres TestApp.resourcesObservação:Se o formulário cujos recursos você está editando é um formulário herdado, tanto sembly sistema autônomo contidos no formulário herdado e sembly sistema autônomo que contém o formulário herdando (derivado) ou deve ser registrado no global sistema autônomo sembly cache (GAC) ou deve residir no mesmo diretório sistema autônomo WinRes.exe. Para obter mais informações sobre como instalar componentes do .NET estrutura no GAC, consulte Cache global de assemblies.
Selecionar controles no formulário e alterar seus Text e Outros propriedades para refletir a cultura localizada e sua linguagem. Mova ou redimensione controles conforme necessário para acomodar o texto localizado.
Para salvar a versão localizada do arquivo resx ou .Recursos, clicar no Salvar ícone ou no mesmo comando o Arquivo menu. A ferramenta exibe o selecionar cultura janela.
selecionar o modo de cultura e o arquivo apropriado, em seguida, clicar OK. A ferramenta salva o arquivo, usando a convenção de nomeclatura que espera o time de execução para os arquivos de recurso localizado. Por exemplo, se você localizar TestApp.resources para alemão na Alemanha, a ferramenta salva o arquivo sistema autônomo TestApp.de-DE.resources. Se você localizar TestApp.resx para alemão na Alemanha, a ferramenta salva o arquivo sistema autônomo TestApp.de-DE.resx. Para obter mais informações sobre convenções de nomenclatura de recursos, consulte Empacotamento e implantação de recursos. Para obter uma lista dos nomes predefinidos cultura usada pelo time de execução, consulte o Classe CultureInfo.