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.

Screenshot of the Find and Replace dialog box in Visual Studio 20222, with the Find in Files tab open.

Screenshot of the Find and Replace dialog box in Visual Studio 2019, with the Find in Files tab open.

Importante

Se você estiver usando o Visual Studio 2019versã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.

    Screenshot of the Find in Files dialog box that includes and outline around the Expression Builder button and the Use Regular Expressions checkbox.

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.

Screenshot of the File Types section of the Find In Files dialog box.

É 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.

    Screenshot of the Find in Files dialog box that includes and outline around the Expression Builder button and the Use Regular Expressions checkbox.

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.

Screenshot of the File Types section of the Find In Files dialog box.

É 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.

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.

Screenshot of the Search Results window with three search results as tabs showing.

Screenshot of the Search Results window with three search results as tabs showing.

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.