Como: Criar arquivos de recursos para sites da Web do ASP.NET

Artigo
10/15/2014

Um arquivo de recurso é um arquivo XML que pode conter sequências de caracteres e outros recursos, como caminhos de arquivos de imagem.Arquivos de recurso são normalmente usados para armazenar sequências de caracteres da interface com o usuário que devem ser traduzidas em outros idiomas.Você pode criar um arquivo de recurso separado para cada linguagem para a qual você deseja traduzir uma página da Web.

Arquivos de recurso globais estão disponíveis para qualquer página ou componente em seu site.Arquivos de recurso locais estão associados a uma única página da Web, a um único controle de usuário ou a uma única página mestra e contêm os recursos para essa página somente.Para obter mais informações, consulte Visão geral sobre recursos de página da Web ASP.NET.

No Visual Web Developer, você pode usar o editor de recursos gerenciado para criar arquivos de recurso globais ou locais.Para arquivos de recurso locais, você também pode gerar um arquivo de recurso cuturalmente neutro diretamente de uma página da Web no designer.

Criar Recursos Manualmente

Para criar um arquivo de recurso manualmente

Certifique-se, seguindo um dos procedimentos abaixo, de que seu site possui uma pasta na qual será armazenado o arquivo de recurso:
- Se você estiver criando um arquivo de recurso global, você deve ter uma pasta chamada App_GlobalResources.Para criar a pasta, no Solution Explorer, clique com o botão direito do mouse no nome do seu site, clique em Add Folder e, em seguida, clique em App_GlobalResources Folder.Só pode haver uma dessas pastas em um aplicativo e ela deve estar localizada na raiz do aplicativo.
- Se você estiver criando um arquivo recurso local, você deve ter uma pasta chamada App_LocalResources.Para criar a pasta, no Solution Explorer, Clique com o botão direito do mouse no nome do seu site, clique em Add Folder e, em seguida, clique em App_LocalResources Folder.Pode haver muitas dessas pastas em um aplicativo e elas podem estar localizadas em qualquer nível no aplicativo.

Para criar um arquivo de recurso, clique com o botão direito do mouse na pasta App_GlobalResources ou na pasta App_LocalResources e, em seguida, clique em Add New Item.

Observação:
Arquivos de recurso globais devem estar na pasta App_GlobalResources.Se você tentar criar um arquivo .resx fora desta pasta, o Visual Web Developer solicitará que você o crie dentro da pasta.

Na caixa de diálogo Add New Item, no Visual Studio installed templates, clique em Assembly Resource File.
Na caixa Name, digite um nome para o arquivo de recursos e, em seguida, clique em Add

O Visual Web Developer irá abrir o arquivo no Managed Resources Editor.O editor exibe uma grade onde você pode inserir nomes (chaves), valores e comentários opcionais.

Digite nomes de chaves e valores para cada recurso que você precise no seu aplicativo e, em seguida, salve o arquivo.

Observação:
Não tente incorporar um gráfico a um arquivo de recurso diretamente, pois os controles não irão ler a sequência de caracteres como um arquivo de imagem em fluxo.Arquivos de recurso representam elementos gráficos armazenando a URL do elemento gráfico como uma sequência de caracteres.

Para criar arquivos de recurso para idiomas adicionais, copie o arquivo no Solution Explorer ou no Windows Explorer, e o renomeie usando um dos seguintes padrões:
- Para arquivos de recurso globais:
  
  name.language.resx
  
  name.language-culture.resx
- Para arquivos de recurso locais:
  
  pageOrControlName.extension.language.resx
  
  pageOrControlName.extension.language-culture.resx
Por exemplo, se você criar um recurso global do arquivo nome d WebResources.resx para a tradução para árabe egípcio, nome o copiados do arquivo WebResources.ar-eg.resx.Para criar um arquivo de recurso relacionado para a tradução para espanhol sem especificar uma cultura, nomeie o arquivo copiado WebResources.es.resx.Note que para arquivos de recursos locais, o nome do arquivo de recurso é o nome da página ou do controle, incluindo o nome da extensão do arquivo e em seguida, a língua e a informação da cultura.
Abra o arquivo copiado e traduza cada valor, deixando os nomes (chaves) originais.
Repita as etapas 6 e 7 para cada linguagem adicional que você deseja usar.

Criando Recursos de uma Página da Web

O seguinte recurso não está disponível com Visual Web Developer Express.

Para gerar um arquivo de recurso local de uma página da Web do ASP.NET

Abra a página para qual você deseja criar um arquivo de recurso.
Alterne para o mode design.
No menu Tools, clique em Generate Local Resource.

O Visual Web Developer irá criar a pasta App_LocalResources se ela ainda não existir.O Visual Web Developer, em seguida, irá criar o arquivo de recurso cuturalmente neutro para a página atual, que inclui um par chave/nome para cada propriedade de controle ou propriedade de página que requer localização.Finalmente, o Visual Web Developer adiciona um atributo meta a cada controle de servidor Web do ASP.NET para configurar o controle para usar localização implícita.Para obter mais informações sobre localização explícita e implícita, consulte Visão geral sobre recursos de página da Web ASP.NET e Como: Usar recursos para conjunto valores de propriedade em controles de servidor Web.

Digite os valores para cada recurso que você precise no seu aplicativo e, em seguida, salve o arquivo.

Observação:
Não tente incorporar um gráfico a um arquivo de recurso diretamente, pois os controles não irão ler a sequência de caracteres como um arquivo de imagem em fluxo.Arquivos de recurso representam elementos gráficos armazenando a URL do elemento gráfico como uma sequência de caracteres.

Se as alterações de recursos mais recentes não forem exibidas, atualize exibição Design, alternando para Modo de exibição Source e, em seguida, alternar de volta para o modo Design.
Crie arquivos de recurso para idiomas adicionais seguindo as etapas 6 e 7 no procedimento anterior.

Para gerar um arquivo recurso global no Visual Web Developer

No Solution Explorer, clique com o botão direito do mouse no nome do site, clique em Adicionar Novo Item e, em seguida, clique em Arquivo de Recursos.

O Visual Web Developer irá perguntar se você deseja colocar o arquivo na pasta App_GlobalResources e se oferece para criar a pasta.
Clique em Yes.

Digite os valores para cada recurso que você precise no seu aplicativo e, em seguida, salve o arquivo.

Observação:
Não tente incorporar um gráfico a um arquivo de recurso diretamente, pois os controles não irão ler a sequência de caracteres como um arquivo de imagem em fluxo.Arquivos de recurso representam elementos gráficos armazenando a URL do elemento gráfico como uma sequência de caracteres.

Se as alterações de recursos mais recentes não forem exibidas, atualize exibição Design, alternando para Modo de exibição Source e, em seguida, alternar de volta para o modo Design.

Para criar arquivos de recurso para idiomas adicionais, copie o arquivo no Solution Explorer ou no Windows Explorer, e o renomeie usando um dos seguintes padrões:

name.language.resx

name.language-culture.resx

Observação:
Ao nomear arquivos de recurso, não inclua .aspx o nome, pois isso pode resultar em um conflito de nomes. Por exemplo, a pasta de recursos não pode conter dois arquivos com nomes como resTestPage.resx e resTestPage.aspx.resx.Nesse caso, a resolução de nomes de arquivo na compilação criaria um conflito de nomenclatura, resultando em um erro em tempo de compilação.