Use arquivos de recurso de aplicativo (.resx) para criar com eficiência um aplicativo Web ASP.NET localizável

  • Artigo

Este artigo descreve como usar o arquivo de recurso para criar um aplicativo Web localizável ASP.NET que você pode exibir em dois idiomas. O método neste artigo usa o Microsoft Visual Studio para preencher o arquivo de recurso usando valores baseados em propriedades de controle para cada página.

Versão original do produto: ASP.NET
Número de KB original: 917414

Resumo

Você pode usar arquivos de recurso de aplicativo (.resx) para criar com eficiência um aplicativo Web do Microsoft ASP.NET localizável. Usando arquivos de recursos, você pode armazenar valores localizados para controles. Os valores localizados são baseados na linguagem e na cultura de um usuário. Quando você armazena valores localizados em arquivos de recursos, ASP.NET pode selecionar o valor apropriado em tempo de execução.

Um aplicativo Web ASP.NET localizável deve conter os seguintes:

  • Um arquivo de recurso (.resx) para armazenar os valores localizados
  • Codificação para associar controles específicos a valores localizados específicos

Este artigo contém um exemplo de local implícito que usa uma combinação de recursos de designer e de editor para produzir um arquivo de recurso.

Observação

É melhor gerar os arquivos de recurso depois de criar o aplicativo Web ASP.NET e depois de adicionar controles à página.

Etapa 1: preparar o aplicativo

Para preparar um novo aplicativo Web ASP.NET para usar valores localizados, siga estas etapas:

  1. Crie um aplicativo Web usando o Visual Studio. Siga estas etapas:

    1. Inicie o Visual Studio.

    2. No menu Arquivo , selecione Site da Web.

    3. Selecione ASP.NET Site da Web, selecione Visual Basic na lista Idioma e, em seguida, selecione OK.

      Observação

      Um novo site é criado e o arquivo Default.aspx é exibido no modo de exibição De origem.

    4. Para alternar para a exibição Design, selecione Design.

  2. Para exibir texto estático, adicione controles à página. Siga estas etapas:

    1. Na caixa de ferramentas, clique duas vezes no controle Rótulo para adicionar um controle Label à página.
    2. Selecione Rótulo.
    3. Na janela Propriedades , digite Data na caixa Texto .
    4. Na caixa de ferramentas, clique duas vezes no controle Rótulo para adicionar um controle Label à página.
    5. Organize esse controle para aparecer no rótulo Date .
    6. Selecione Rótulo.
    7. Na janela Propriedades , digite Tempo na caixa Texto .

  3. Para exibir texto dinâmico, adicione controles à página. Siga estas etapas:

    1. Na caixa de ferramentas, clique duas vezes no controle Rótulo para adicionar um controle Label à página.

    2. Organize esse controle para aparecer à direita do rótulo Date .

    3. Na caixa de ferramentas, clique duas vezes no controle Rótulo para adicionar um controle Label à página.

    4. Organize esse controle para aparecer à direita do rótulo Time .

    5. Clique duas vezes na página e adicione o código a seguir ao Page_Load método.

       Label3.Text = Format(Now(), "H:mm")
 Label4.Text = Date.Now.Date

Etapa 2: gerar os arquivos de recurso automaticamente

Para gerar os arquivos de recurso automaticamente, siga estas etapas:

  1. Em Gerenciador de Soluções, clique duas vezes no arquivo Default.aspx.

    Observação

    O arquivo Default.aspx é aberto no modo Design.

  2. No menu Ferramentas , selecione Gerar Recursos Locais.

    Observação

    Por padrão, uma nova pasta chamada App_LocalResources é criada. Além disso, um arquivo de recurso chamado Default.aspx.resx é criado. Este arquivo contém informações sobre cada controle Label na página. Os valores no arquivo de recurso correspondem aos valores que você inseriu para cada controle Label na exibição Design.

  3. Em Gerenciador de Soluções, clique com o botão direito do mouse no arquivo Default.aspx.resx e selecione Copiar.

  4. Em Gerenciador de Soluções, clique com o botão direito do mouse na pasta App_LocalResources e selecione Colar.

  5. Em Gerenciador de Soluções, clique com o botão direito do mouse no arquivo Copiar de Default.aspx.resx e selecione Renomear.

  6. Digite Default.aspx.es-mx.resx e pressione ENTER.

    Observação

    • As etapas 3 a 6 criam um arquivo de recurso localizado para o idioma espanhol. Você pode criar um arquivo de recurso localizado incluindo o idioma e a cultura entre .aspx e .resx no nome do arquivo.
    • Para editar os valores localizados em vários arquivos de recursos, abra os arquivos de recursos no Visual Studio e altere as propriedades de cada controle localizado.

Etapa 3: testar o aplicativo

Para testar o aplicativo, siga estas etapas:

  1. No menu Depuração , selecione Iniciar Depuração.

    Observação

    Por padrão, o Microsoft Internet Explorer é iniciado e o arquivo Default.aspx do aplicativo Web ASP.NET é exibido.

  2. No menu Ferramentas na Internet Explorer, selecione Opções de Internet.

  3. Na caixa de diálogo Opções da Internet , selecione a guia Geral e selecione Idiomas.

  4. Na caixa de diálogo Preferências de Idioma , selecione Adicionar.

  5. Na caixa de diálogo Adicionar Idioma , selecione Espanhol (México) [es-mx]e clique em OK.

  6. Na caixa de diálogo Preferências de Idioma , selecione Espanhol (México) [es-mx], selecione Mover Para Cima e, em seguida, selecione OK.

  7. Para fechar a caixa de diálogo Opções da Internet , selecione OK.

  8. Para exibir o conteúdo localizado na página usando as novas configurações de idioma, selecione Atualizar no menu Exibir .

Referências