Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Arquivos de recurso 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 precisar recompilar seus binários. Se você estiver planejando localizar seu aplicativo, deverá usar arquivos de recurso para todas as cadeias de caracteres e outros recursos que precisam ser alterados ao localizar seu aplicativo.
Cuidado
Os recursos em arquivos .resx podem ser serializados usando BinaryFormatter, que não é seguro. Inclua somente os arquivos .resx no processo de build 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 duas maneiras:
- Clicando com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecionando Propriedades
- Digitando propriedades do projeto na caixa de pesquisa Ctrl+Q
- Pressionando AltEnter no +de Soluções
Selecione a guia Recursos . Você pode adicionar um arquivo .resx se o projeto ainda não contiver um, adicionar e excluir diferentes tipos de recursos e modificar recursos existentes.
Melhorias do Resource Explorer no Visual Studio 2022 e posterior
A partir do Visual Studio 2022 versão 17.11, o gerenciador de recursos foi significativamente aprimorado. Consulte a introdução do 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 junto com as localidades de cada arquivo. Você pode configurar quais localidades estão visíveis no datagrid. Essa interface permite comparar traduções lado a lado e editá-las no local.
Pesquisar cadeias de caracteres de recurso
No canto superior esquerdo da grade, você pode usar a caixa de pesquisa para fazer um texto de pesquisa de todos os seus arquivos de recurso. Para pesquisar um recurso, digite a caixa de pesquisa na barra de ferramentas e pressione Enter. A grade de dados mostrará apenas os recursos que correspondem à consulta em seu nome, valor ou comentário. Você pode usar caracteres curinga (*) para fazer correspondências parciais e aspas (") para fazer 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 na qual você deseja comentar e clique no botão Editar Comentário na barra de ferramentas ou pressione Shift+Enter. Uma caixa de comentário é exibida abaixo da célula, em que 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 exibir todos os comentários de um recurso, procure o ícone de triângulo pequeno no canto de cada célula que tenha 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 recurso. O tradutor, um desenvolvedor ou um gerenciador de recursos pode deixar anotações, perguntas, explicações ou ressalvas junto com as 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 você deseja aplicar. Você pode filtrar recursos por nome, valor, comentário, tipo ou arquivo.
| Filtro | Descrição |
|---|---|
| Nome | Mostrar somente 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 somente os recursos que têm um comentário ou contêm uma determinada cadeia de caracteres em seu comentário. |
| Tipo | Mostrar somente os recursos que têm um determinado tipo, como cadeia de caracteres, imagem ou ícone. |
| Arquivo | Mostrar somente os recursos que pertencem a um determinado arquivo ou cultura. |
Você pode combinar vários filtros para restringir seus resultados e desmarcá-los clicando no botão Limpar Filtro.
Validação e avisos
Espaços reservados são tokens especiais que são substituídos por valores dinâmicos em tempo de execução, como {0}, {1} ou {name}. Caso você utilize placeholders em seus recursos, precisará garantir que eles sejam consistentes em todas as localizações; senão, poderá ver erros ou comportamentos inesperados em seu aplicativo.
O novo Gerenciador 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 "Hello, {name}!" e o valor em 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 nele para corrigi-lo.
Traduções ausentes são 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 retornará à cultura padrão, o que pode não ser adequado ou desejável para alguns usuários. O Gerenciador de Recursos ajuda você a evitar esse problema mostrando um ícone de aviso se não houver valor para um recurso em uma determinada cultura. Por exemplo, se> você tiver um recurso com um valor File padrão e nenhum valor para a cultura francesa, verá um ícone de aviso mostrando que a tradução está ausente. 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 Resource Explorer no Visual Studio 2022 e posterior é compatível com leitores de tela e tecnologia assistiva, tornando-o mais acessível para desenvolvedores com deficiências visuais ou outras deficiências. 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 ampliar ou reduzir. Use Ctrl+0 para redefinir o nível de zoom como padrão.
O tema do Gerenciador de Recursos é consistente com o restante do ambiente do Visual Studio. Você pode escolher entre temas claros, escuros ou azuis e o Gerenciador de Recursos se adaptará adequadamente. Você também pode alterar a fonte e as cores da grade de informações, usando a caixa de diálogo Fontes e Cores do > de Opções de >.
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 os recursos de aplicativo e o Sistema de Gerenciamento de Recursos
- Projetos C++/CLI (gerenciados), consulte Recursos em Aplicativos da Área de Trabalho
- Projetos do C++, consulte Trabalhar com arquivos de recursos e Como criar um recurso
- Use a janela Modo de Exibição de Recurso (Exibir>Outras Janelas>Modo de Exibição de Recurso) para exibir arquivos de recursos incluídos em seus projetos.
Opções de suporte
Se você encontrar um problema com o gerenciamento de recursos do aplicativo, consulte Solucionar erros no Editor de Recursos.