Compartilhar via


Localizar em Arquivos

O Localizar nos Arquivos permite pesquisar um conjunto de arquivos especificado. As correspondências encontradas pelo Visual Studio estão listadas na janela Localizar resultados no IDE. A aparência dos resultados depende das opções escolhidas na guia Localizar nos arquivos da caixa de diálogo Localizar e Substituir.

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

A captura de tela da caixa de diálogo Localizar e Substituir no Visual Studio 2019, com a guia aberta Localizar nos Arquivos.

Importante

Se você estiver usando o Visual Studio 2019 versão 16.6 ou anterior, a caixa de diálogo Localizar e Substituir poderá não se parecer com a que aparece aqui. Alterne para a versão do Visual Studio 2017 desta página para obter descrições que corresponderão ao que você vê em sua tela.

Como exibir Localizar nos arquivos

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

  1. Pressione Ctrl+Q e insira "localizar" na caixa de pesquisa na parte superior da tela.

  2. Selecione Localizar nos arquivos na lista de resultados.

ou

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

  2. Selecione Localizar nos arquivos no menu suspenso.

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

Observação

A ferramenta Localizar e Substituir não pesquisa diretórios com o atributo Hidden ou 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.

É possível 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 retorna 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 Pesquisar (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 será exibido ao lado da caixa Pesquisar somente se você tiver marcado a caixa de seleção Usar expressões regulares.

    Captura de tela da caixa de diálogo Localizar nos Arquivos que inclui e destaca o botão Construtor de Expressões e da caixa de seleção Usar Expressões Regulares.

Examinar

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

Também é possível usar o botão adjacente Procurar (...) para localizar onde deseja pesquisar. Melhor ainda, se você já tiver especificado um diretório, esse botão acrescenta o novo diretório em vez de substituí-lo. Por exemplo, se o valor "Pesquisar" for ".\Code", é necessário clicar no botão Procurar (...) e navegar até uma pasta chamada "Código Compartilhado". A caixa Procurar (...) agora mostraria ".\Code;. \Código Compartilhado" e quando o comando Localizar for executado, a pesquisa é feita nessas duas pastas.

Para refinar sua pesquisa, é possível 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" que são incluídos pelos arquivos de código, mas 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, como arquivos abertos, mas que não fazem parte de uma solução. Confira Arquivos diversos.

Tipos de arquivo

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

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

É possível pesquisar vários tipos de arquivo separando-os com um ponto e vírgula (;). Exclua também pastas e arquivos com o prefixo de qualquer caminho ou tipo de arquivo com um ponto de exclamação (!).

Acrescentar resultados

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

Caixa de pesquisa

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.

É possível 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 retorna 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 Pesquisar (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 será exibido ao lado da caixa Pesquisar somente se você tiver marcado a caixa de seleção Usar expressões regulares.

    Captura de tela da caixa de diálogo Localizar nos Arquivos que inclui e destaca o botão Construtor de Expressões e da caixa de seleção Usar Expressões Regulares.

Examinar

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

Também é possível usar o botão adjacente Procurar (...) para localizar onde deseja pesquisar. Melhor ainda, se você já tiver especificado um diretório, esse botão acrescenta o novo diretório em vez de substituí-lo. Por exemplo, se o valor "Pesquisar" for ".\Code", é necessário clicar no botão Procurar (...) e navegar até uma pasta chamada "Código Compartilhado". A caixa Procurar (...) agora mostraria ".\Code;. \Código Compartilhado" e quando o comando Localizar for executado, a pesquisa é feita nessas duas pastas.

Para refinar sua pesquisa, é possível selecionar ou desmarcar as seguintes opções:

  • Incluir itens externos – use essa opção para incluir itens externos, como arquivos como "windows.h" que você pode fazer referência, mas não faz parte de uma solução.
  • Incluir arquivos diversos – use essa opção para incluir arquivos diversos, como arquivos abertos, mas que não fazem parte de uma solução.

Tipos de arquivo

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

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

É possível pesquisar vários tipos de arquivo separando-os com um ponto e vírgula (;). Exclua também pastas e arquivos com o prefixo de qualquer caminho ou tipo de arquivo com um ponto de exclamação (!).

Acrescentar resultados

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

Resultados da Pesquisa

Quando é feita uma pesquisa para todos os resultados, eles aparecem conforme ficam disponíveis.

Observação

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ê fizer a pesquisa enquanto o Visual Studio ainda estiver indexando seus arquivos de origem, é possível visualizar um aviso 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 trabalho, poderá clicar no í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 a necessidade de reabrir a janela Localizar.

Captura de tela mostrando o botão de atualização.

Modificar localização

Use o botão Modificar Busca (Repetir Busca 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 Localizar reabre Localizar em Arquivos com seus critérios de pesquisa anteriores para esse conjunto de resultados.

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

Manter Resultados

É possível manter os resultados de uma pesquisa enquanto executa outras pesquisas. 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 como guias exibidas.

Captura de tela da janela Resultados da Pesquisa com três resultados de pesquisa como guias exibidas.

Para manter vários resultados da pesquisa, selecione o botão Manter Resultados após cada pesquisa. Depois, quando você pesquisa outra coisa, os resultados são mostrados em uma nova guia. É possível manter os resultados de até cinco pesquisas. Se você já tiver cinco resultados de pesquisa exibidos, a próxima pesquisa reutilizará a guia de resultados da pesquisa mais antiga.

No Visual Studio 2022 e versões posteriores, é possível definir o Visual Studio para sempre manter os resultados. Acesse Ferramentas>Opções>Geral>Localizar e Substituir e marque a caixa de seleção Manter resultados da pesquisa por padrão.