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.
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.
Pressione Ctrl+Q e insira "localizar" na caixa de pesquisa na parte superior da tela.
Selecione Localizar nos arquivos na lista de resultados.
ou
Na barra de menus, selecione Editar>Localizar e Substituir.
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
.
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.
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.
É 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.
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.
É 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.
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.
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.
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.