Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Os arquivos de recursos são arquivos que fazem parte de um aplicativo, mas não são compilados, por exemplo, arquivos de ícone ou arquivos de áudio. Como esses arquivos não fazem parte do processo de compilação, você pode alterá-los sem ter que recompilar seus binários. Se você estiver planejando localizar seu aplicativo, você deve usar arquivos de recursos para todas as cadeias de caracteres e outros recursos que precisam ser alterados quando você localizar seu aplicativo.
Atenção
Recursos em arquivos .resx podem ser serializados usando BinaryFormatter, que não é seguro. Inclua apenas os arquivos .resx em seu processo de compilação em que você confia.
Para obter mais informações sobre recursos em aplicativos .NET, consulte Recursos em aplicativos .NET.
Trabalhar com recursos
Em um projeto de código gerenciado, abra a janela de propriedades do projeto. Você pode abrir a janela de propriedades de uma das seguintes maneiras:
- Clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Propriedades
- Digitando propriedades do projeto na caixa de pesquisa Ctrl+Q
- Pressionando Alt+Enter no Gerenciador de Soluções
Selecione a guia Recursos . Você pode adicionar um arquivo .resx se seu projeto ainda não contiver um, adicionar e excluir diferentes tipos de recursos e modificar recursos existentes.
Aprimoramentos do Gerenciador de Recursos no Visual Studio 2022 e posterior
A partir do Visual Studio 2022 versão 17.11, o explorador de recursos foi significativamente melhorado. Consulte Apresentando o Gerenciador de Recursos do Visual Studio renovado.
Para usar o novo Gerenciador de Recursos, você precisa ter um projeto .NET que contenha um ou mais arquivos de recurso (.resx). Para abrir o Gerenciador de Recursos, clique com o botão direito do mouse em qualquer arquivo de recurso no Gerenciador de Soluções e selecione Abrir com>o Gerenciador de Recursos. Como alternativa, você pode usar o atalho de teclado Ctrl+Alt+R.
Ao abrir o novo Gerenciador de Recursos, no lado esquerdo, você verá uma visão geral de todos os recursos armazenados ao lado das localidades de cada arquivo. Você pode configurar quais localidades são visíveis na grade de dados. Esta interface permite-lhe comparar traduções lado a lado e editá-las no local.
Pesquisar cadeias de caracteres de recursos
No canto superior esquerdo da grade, pode usar a caixa de pesquisa para realizar uma pesquisa de texto em todos os seus ficheiros de recursos. Para procurar um recurso, digite na caixa de pesquisa na barra de ferramentas e pressione Enter. A grade de dados mostrará apenas os recursos que correspondem à sua consulta em seu nome, valor ou comentário. Você pode usar curingas (*) para executar correspondências parciais e aspas (") para executar correspondências exatas.
Adicionar comentários a traduções específicas de um recurso
Os comentários são uma maneira útil de fornecer mais informações ou contexto para um recurso, como o significado, o uso ou o tom de uma cadeia de caracteres. No Gerenciador de Recursos, você pode adicionar comentários a cada tradução de um recurso e exibi-los todos de uma vez na grade de dados.
Para adicionar um comentário a um recurso, selecione a célula que corresponde à tradução que você deseja comentar e clique no botão Editar comentário na barra de ferramentas ou pressione Shift+Enter. Uma caixa de comentário aparece abaixo da célula, onde você pode digitar seu comentário. Pressione Enter para salvar o comentário ou Esc para descartá-lo.
Você pode editar ou excluir comentários existentes clicando na caixa de comentários ou usando o mesmo atalho de teclado. Para ver todos os comentários de um recurso, procure o pequeno ícone de triângulo no canto de cada célula que tem um comentário. Você pode passar o mouse sobre o ícone para ver uma dica de ferramenta com o texto do comentário ou clicar nele para abrir a caixa de comentários.
Os comentários estão disponíveis para vários usuários dos arquivos de recursos. O tradutor, um desenvolvedor ou um gerente de recursos pode deixar anotações, perguntas, explicações ou advertências ao lado das traduções. Um pequeno ícone no canto de cada célula indica a presença de um comentário.
Filtrar recursos
Para filtrar recursos, clique no ícone de filtro na barra de ferramentas e selecione os critérios que deseja aplicar. Você pode filtrar recursos por nome, valor, comentário, tipo ou arquivo.
| Filtro | Descrição |
|---|---|
| Nome | Mostrar apenas os recursos que têm um determinado nome ou prefixo. |
| Valor | Mostrar apenas os recursos que têm um determinado valor ou contêm uma determinada cadeia de caracteres. |
| Comentário | Mostrar apenas os recursos que têm um comentário ou contêm uma determinada cadeia de caracteres em seu comentário. |
| Tipo | Mostrar apenas os recursos que têm um determinado tipo, como cadeia de caracteres, imagem ou ícone. |
| Ficheiro | Mostrar apenas os recursos que pertencem a um determinado arquivo ou cultura. |
Você pode combinar vários filtros para restringir seus resultados e limpá-los clicando no botão Limpar filtro.
Validação e avisos
Os espaços reservados são tokens especiais que são substituídos por valores dinâmicos durante a execução, como {0}, {1} ou {name}. Se você usar espaços reservados em seus recursos, precisará garantir que eles sejam consistentes em todas as localizações, caso contrário, você poderá ver erros ou comportamento inesperado em seu aplicativo.
O novo Explorador de Recursos valida automaticamente os espaços reservados para cada recurso e mostra um ícone de aviso se houver uma incompatibilidade entre a cultura padrão e qualquer outra localização. Por exemplo, se o valor padrão de um recurso for "Olá, {nome}!" e o valor espanhol for "Hola, {nombre}!", você verá um ícone de aviso mostrando que o nome do espaço reservado é diferente. Você pode passar o mouse sobre o ícone para ver uma dica de ferramenta com os detalhes da incompatibilidade e clicar nela para corrigi-la.
A falta de traduções é outro problema comum que pode afetar a experiência do usuário do seu aplicativo. Se você não fornecer uma tradução para um recurso em uma determinada cultura, o aplicativo voltará para a cultura padrão, que pode não ser adequada ou desejável para alguns usuários. O Explorador de Recursos ajuda a evitar esse problema mostrando um ícone de aviso se não houver valor para um recurso em uma determinada cultura. Por exemplo, se> tiver um recurso com um valor padrão de File e nenhum valor para a cultura francesa, verá um ícone de aviso File indicando que a tradução está em falta. Você pode passar o mouse sobre o ícone para ver uma dica de ferramenta com a mensagem Sem valor e selecioná-la para adicionar um valor.
Opções de personalização
O Explorador de Recursos no Visual Studio 2022 e posterior é compatível com leitores de tela e tecnologia assistiva, para torná-lo mais acessível para desenvolvedores com deficiências visuais. Você pode usar atalhos de teclado para navegar pela grade de dados, editar valores e comentários e executar ações comuns. Você também pode usar o narrador para ler o conteúdo de cada célula, bem como as dicas de ferramentas e avisos.
Para ajustar o nível de zoom, use o controle deslizante de zoom na barra de ferramentas ou os atalhos de teclado Ctrl+= e Ctrl+- para aumentar ou diminuir o zoom. Use Ctrl+0 para redefinir o nível de zoom para o padrão.
O tema para o Resource Explorer é consistente com o resto do ambiente do Visual Studio. Você pode escolher entre temas claros, escuros ou azuis, e o Explorador de Recursos se adaptará de acordo. Você também pode alterar a fonte e as cores da grelha de dados, usando o Ferramentas>Opções>Ambiente>Fontes e Cores caixa de diálogo.
Recursos em outros tipos de projeto
Os recursos são gerenciados de forma diferente em projetos .NET do que em outros tipos de projeto. Para obter mais informações sobre recursos em:
- Aplicativos da Plataforma Universal do Windows (UWP), consulte Recursos do aplicativo e o Sistema de Gerenciamento de Recursos
- Projetos C++/CLI (gerenciados), consulte Recursos em aplicativos de área de trabalho
- Projetos C++, consulte Trabalhar com arquivos de recursos e Como criar um recurso
- Use a janela Vista de Recursos (Ver>Outras Janelas>Vista de Recursos) para exibir arquivos de recursos incluídos nos seus projetos.
Opções de suporte
Se você tiver um problema com o gerenciamento de recursos do aplicativo, consulte Solucionar erros no Editor de recursos.