Compartilhar via


Localizar em Arquivos

Localizar em Arquivos permite que você pesquise um conjunto de arquivos especificado. O Visual Studio lista os resultados correspondentes na janela Localizar Resultados no IDE. A aparência dos resultados depende das opções escolhidas na guia Localizar em Arquivos da caixa de diálogo Localizar e Substituir.

Captura de tela da caixa de diálogo Localizar e Substituir no Visual Studio, com a guia Localizar em Arquivos aberta.

Captura de tela da caixa de diálogo Localizar e Substituir no Visual Studio 2022, com a guia Localizar em Arquivos aberta.

Como exibir Localizar em Arquivos

Use as etapas a seguir para abrir a caixa de diálogo Localizar e Substituir ou pressione Ctrl+Shift+F.

  1. Na barra de menus, selecione Editar>Localizar e Substituir.

  2. Selecione Localizar em Arquivos no menu suspenso.

Para cancelar uma operação Localizar, pressione Ctrl+Break.

Nota

A ferramenta Localizar e Substituir não pesquisa diretórios com o atributo Hidden ou o atributo System.

Para pesquisar uma nova cadeia de caracteres de texto ou expressão, especifique-a na caixa Pesquisar. Para pesquisar qualquer uma das 20 cadeias de caracteres mais pesquisadas recentemente, abra a lista suspensa e selecione a cadeia de caracteres.

Você pode selecionar ou desmarcar as seguintes opções:

  • Diferenciar maiúsculas de minúsculas – use essa opção para garantir que a pesquisa diferencia maiúsculas de minúsculas.

  • Localizar palavras inteiras – use essa opção para garantir que sua pesquisa retorne apenas resultados de palavras inteiras.

  • Usar expressões regulares – use essa opção para notações especiais que definem padrões de texto para o resultado na caixa de Pesquisa (ou na caixa de texto Substituir). Para obter uma lista dessas notações, consulte Usando expressões regulares no Visual Studio.

    Importante

    O botão Construtor de Expressões aparece ao lado da caixa de Pesquisa somente se você tiver selecionado a caixa de seleção Usar expressões regulares.

    Captura de tela da caixa de diálogo Localizar em Arquivos que inclui um destaque em torno do botão Construtor de Expressões e da caixa de seleção Usar Expressões Regulares.

Pesquisar em

A opção escolhida na lista suspensa Pesquisar em determina se Localizar em Arquivos pesquisa em todo o workspace, toda a solução, o projeto atual, o diretório atual, todos os documentos abertos ou o documento atual.

Você também pode usar o botão Procurar (...) adjacente para localizar onde deseja pesquisar. Melhor ainda, se você já especificou um diretório, esse botão acrescentará o novo diretório em vez de substituí-lo. Por exemplo, se o valor "Procurar em" fosse ".\Código", você poderia selecionar o botão Procurar (...) e navegar até uma pasta denominada "Código Compartilhado". A caixa Procurar (...) agora mostraria ".\Code;. \Código Compartilhado" e quando o comando Localizar é executado, ele pesquisa ambas as pastas.

Para refinar sua pesquisa, você pode selecionar ou desmarcar as seguintes opções:

  • Incluir itens externos – use essa opção para incluir arquivos referenciados de fora de um projeto C++, ou seja, arquivos como "windows.h" incluídos pelos arquivos de código, mas que não fazem parte de uma solução. Essa opção só se aplica a projetos C++.
  • Incluir arquivos diversos – use essa opção para incluir arquivos diversos, que são arquivos que você abriu, mas não fazem parte de uma solução. Confira Arquivos diversos.

Tipos de arquivo

A opção Tipos de arquivo indica os tipos de arquivos que serão pesquisados nos diretórios Pesquisar em. Selecione qualquer item na lista para inserir uma cadeia de caracteres de pesquisa pré-configurada que encontrará arquivos desses tipos específicos.

Captura de tela da seção Tipos de Arquivo da caixa de diálogo Localizar em Arquivos.

Você pode pesquisar vários tipos de arquivo separando-os com um ponto-e-vírgula (;). Você também pode excluir pastas e arquivos prefixando qualquer caminho ou tipo de arquivo com um ponto de exclamação (!).

Você pode excluir permanentemente alguns arquivos da pesquisa; consulte Excluir arquivos da pesquisa. Para alternar essas exclusões, use o botão.

Captura de tela mostrando o botão de alternância para exclusões de arquivo.

Acrescentar resultados

Use essa opção para acrescentar os resultados da pesquisa atual aos resultados da pesquisa anterior.

Resultados da pesquisa

Quando você executa uma pesquisa para todos os resultados, os resultados aparecem conforme eles ficam disponíveis.

Nota

O Visual Studio começa a criar um índice depois que o contexto de código é carregado, como ao abrir um novo projeto, alterar branches ou alterar a lista de arquivos. Se você pesquisar enquanto o Visual Studio ainda estiver indexando seus arquivos de origem, poderá ver um aviso de que os resultados estão incompletos.

Com o Visual Studio 17.12 e posterior, se você quiser repetir a mesma pesquisa depois de fazer mais trabalhos, poderá selecionar o ícone de seta no sentido horário para atualizar os resultados. Isso garante que todas as alterações feitas desde a última Localização sejam refletidas sem precisar reabrir a janela Localizar.

Captura de tela mostrando o botão atualizar.

Modificar busca

Use o botão Modificar Localizar (Repetir Localizar em algumas versões) na janela de resultados para refinar os critérios de pesquisa sem precisar recriar os mesmos critérios de pesquisa na janela Localizar. Clicar em Modificar Busca reabre Localizar em Arquivos com seus critérios de pesquisa anteriores para este conjunto de resultados.

Captura de tela mostrando o botão Modificar Localizar e os critérios de pesquisa que você pode modificar.

Manter resultados

Você pode manter os resultados de uma pesquisa enquanto executa outras pesquisas. Isso facilita a comparação de resultados e vê-los lado a lado.

Captura de tela da janela Resultados da Pesquisa, com três resultados de pesquisa exibidos como abas.

Para manter vários resultados da pesquisa, selecione o botão Manter Resultados após cada pesquisa. Em seguida, quando você procura outra coisa, os resultados são mostrados em uma nova guia. Você pode manter os resultados de até cinco pesquisas. Se você já tiver cinco resultados de pesquisa mostrando, a próxima pesquisa reutilizará a guia de resultados da pesquisa mais antiga.

Você pode definir o Visual Studio para sempre manter os resultados. No painel FerramentasOpções, expanda a seção Todas as ConfiguraçõesAmbienteLocalizar e Substituir. No grupo Localizar em Arquivos , selecione a caixa de seleção Manter os resultados da pesquisa por padrão .

No Visual Studio 2022 e posterior, você pode definir o Visual Studio para sempre manter os resultados. Na caixa de diálogo Ferramentas>Opções, expanda a seção Ambiente>Localizar e Substituir e selecione a caixa de seleção Manter os resultados da pesquisa por padrão.