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.
Neste artigo, você aprenderá a localizar e substituir texto no editor do Visual Studio usando a opção de "localizar e substituir" em um único arquivo (Ctrl+ ou Ctrl+) ou em vários arquivos (CtrlShift+F ou +Shift+H). Você também pode encontrar e substituir algumas instâncias de um padrão usando a seleção de múltiplos cursores. Além do editor, você também pode encontrar e substituir texto em determinadas outras janelas baseadas em texto, como as janelas Localizar Resultados , em janelas de designer, como o designer XAML e o designer do Windows Forms e em janelas de ferramentas.
Observação
Se você estiver procurando informações sobre o Visual Studio Code, acesse os localizar e substituir documentos no VS Code.
Dica
Se você quiser renomear símbolos de código, como variáveis e métodos, é melhor refatorá-los do que usar localizar e substituir. A refatoração é inteligente e reconhece o escopo, enquanto o recurso Localizar e Substituir substitui cegamente todas as instâncias. Com o Visual Studio 2022 versão 17.6 ou posterior, você também pode usar All in One Search para pesquisar código de forma inteligente, de uma forma que considere o significado semântico do seu código, não apenas o texto em si.
Você pode definir o escopo de pesquisas para o documento atual, a solução atual ou um conjunto personalizado de pastas. Você também pode especificar um conjunto de extensões de nome de arquivo para pesquisas de vários arquivos. Personalize a sintaxe de pesquisa usando expressões regulares do .NET.
Dica
A caixa Localizar/Comando está disponível como um controle de barra de ferramentas, mas não está visível por padrão. Para exibir a caixa Localizar/Comando , selecione Adicionar ou Remover Botões na barra de ferramentas Padrão e selecione Localizar.
Localizar e substituir em um único arquivo
- Pressione Ctrl+F como um atalho para localizar uma cadeia de caracteres no arquivo atual.
- Pressione Ctrl+H como um atalho para localizar e substituir uma cadeia de caracteres no arquivo atual.
O controle Localizar e Substituir aparece no canto superior direito da janela do editor de código. Ele realça imediatamente todas as ocorrências da cadeia de caracteres de pesquisa fornecida no documento atual. Você pode navegar de uma ocorrência para outra escolhendo o botão Localizar Próximo ou o botão Localizar Anterior no controle de pesquisa.
Você pode acessar as opções de substituição escolhendo o botão ao lado da caixa de texto Localizar . Para fazer uma substituição por vez, escolha o botão Substituir próximo ao lado da caixa de texto Substituir. Para substituir todas as correspondências, escolha o botão Substituir tudo.
Para alterar a cor de realce das correspondências, escolha o menu Ferramentas, selecione Opções e, em seguida, escolha Ambiente e selecione Fontes e Cores. Na lista Mostrar configurações , selecione Editor de Texto e, na lista De itens de exibição , selecione Localizar Realce de Correspondência.
Janelas de ferramentas de pesquisa
Você pode usar o controle Localizar em janelas de código ou texto, como janelas de saída e janelas Localizar Resultados , selecionando Editar>Localizar e Substituir ou pressionando Ctrl+F.
Uma versão do controle Localizar também está disponível em algumas janelas de ferramentas. Por exemplo, você pode filtrar a lista de controles na janela Caixa de Ferramentas inserindo texto na caixa de pesquisa. Outras janelas de ferramentas que permitem que você pesquise seu conteúdo incluem o Gerenciador de Soluções, a janela Propriedades e o Team Explorer.
Localizar e substituir em vários arquivos
Localizar em Arquivos permite que você pesquise um conjunto de arquivos especificado. As correspondências que o Visual Studio encontra estão listadas na janela Resultados da Pesquisa na IDE. A aparência dos resultados depende das opções escolhidas na caixa de diálogo Localizar e Substituir .
Abra a caixa de diálogo Localizar e Substituir pressionando Ctrl+Shift+F ou:
- Na barra de menus, selecione Editar>Localizar e Substituir.
- Selecione Localizar nos arquivos no menu suspenso.
- Na barra de menus, selecione Editar>Localizar e Substituir.
- Selecione Localizar nos arquivos no menu suspenso.
Para expor a caixa de texto Substituir , use a seta para baixo à esquerda do texto Localizar ou escolha a guia Substituir em Arquivos. Ao alternar para o modo de substituição, um campo de texto adicional é exibido para o texto de substituição, além de uma caixa de seleção com a opção de preservar a capitalização ao substituir o texto.
Defina o escopo da pesquisa e substitua a operação como:
- O arquivo aberto no momento
- Todos os documentos abertos
- A solução inteira
- O projeto atual
- Conjuntos de pastas especificados
- Extensões de arquivo especificadas
A ferramenta Localizar e Substituir não pesquisa diretórios com o atributo Hidden ou System.
Você pode excluir permanentemente alguns arquivos da pesquisa; consulte Excluir arquivos da pesquisa.
Cancelar uma pesquisa
Para cancelar uma operação Localizar ou Substituir, pressione Ctrl+Break.
Para obter mais informações, consulte Localizar em arquivos e Substituir em arquivos e, para saber mais sobre como usar expressões regulares, consulte Usar Expressões Regulares.
Localizar Resultados
Quando você escolhe Localizar Tudo, uma janela Localizar Resultados é aberta e lista as correspondências para sua pesquisa. Selecionar um resultado na lista exibe o arquivo associado e realça a correspondência. Se o arquivo ainda não estiver aberto para edição, ele será aberto em uma guia de visualização no lado direito da guia. Você pode usar o controle Localizar para pesquisar por meio da lista Localizar Resultados .
Criar conjuntos de pastas de pesquisa personalizados
Você pode definir um escopo de pesquisa escolhendo o botão Escolher Pastas de Pesquisa (parece ...) ao lado da caixa Examinar . Na caixa de diálogo Escolher Pastas de Pesquisa , você pode especificar um conjunto de pastas a serem pesquisadas e salvar a especificação para poder reutilizá-la mais tarde.
Dica
Se você mapeou o disco de um computador remoto para seu computador local, poderá especificar pastas para pesquisar no computador remoto.
Criar conjuntos de componentes personalizados
Você pode definir conjuntos de componentes como seu escopo de pesquisa escolhendo o botão Editar Conjunto de Componentes Personalizado ao lado da caixa Pesquisar . Você pode especificar componentes .NET ou COM instalados, projetos do Visual Studio incluídos em sua solução ou qualquer assembly ou biblioteca de tipos (.dll, .tlb, .olb, .exeou .ocx). Para pesquisar referências, selecione a caixa Pesquisar referências .
Excluir arquivos da pesquisa
Você pode excluir arquivos específicos, como artefatos de build, scripts minificados ou arquivos gerados, que você não deseja incluir na pesquisa típica.
Para configurar arquivos a serem excluídos, acesse Ferramentas > Opções > Ambiente > Pesquisa e procure a seção Excluir arquivos dos resultados da pesquisa. Lá, você pode adicionar, editar ou remover padrões glob para controlar exatamente quais arquivos são deixados de fora dos resultados da pesquisa.
Essas exclusões são aplicadas automaticamente na Localização Rápida. Para Localizar em Arquivos, essas exclusões são aplicadas além de quaisquer exclusões no campo Tipos de arquivo. Você pode ativar ou desativar as exclusões de nível de configurações por meio do botão de alternância à direita dos tipos de arquivo.
Seleção de vários cursores
Use a seleção de vários cursores para fazer a mesma edição em dois ou mais locais ao mesmo tempo. Por exemplo, você pode inserir o mesmo texto ou modificar o texto existente em vários locais ao mesmo tempo.
No Visual Studio 2022 e posterior, colar várias linhas no mesmo número de conjuntos insere cada linha em um respectivo conjunto. Em versões anteriores, a colagem de várias linhas em vários conjuntos gera a duplicação de toda a área de transferência em cada conjunto.
Para usar vários sinais, pressione Ctrl+Alt+clique do mouse ou Alt+Shift+. Em seguida, use Ctrl+Shift+tecla de direção para expandir as seleções. Em seguida, pressione Ctrl+C para copiar o texto em várias seleções. Use Alt+Shift+clique do mouse para criar vários conjuntos de caracteres para cada linha colar onde você quiser. Por fim, pressione Ctrl+V para colar cada linha em seu próprio cursor.
Para selecionar várias caretas:
- Use Alt+Shift+tecla de seta para cima (ou tecla de seta para baixo) ou Alt+Shift+arrastar mouse para selecionar com vários conjuntos de caracteres. Se você preferir continuar usando uma seleção de caixa com Alt+Shift+teclas de direção e Alt+Shift+arrastar mouse quando expandir uma seleção de vários cursores, acesse Ferramentas>Opções>Editor de texto>Avançado e selecione Usar seleção de caixa.
- Como alternativa, acesse a seleção de vários cursores na barra de menus selecionando Editar>Vários Cursores e selecionando a ação desejada.
| Atalho de teclado com vários cursores | Ação | Comando |
|---|---|---|
| Alt+Shift+. | Usar vários cursores | Edit.InsertNextMatchingCaret |
| Ctrl+Shift+tecla de seta | Expandir seleções | Edit.ControleDeTamanhoParaCima, Edit.ControleDeTamanhoParaBaixo, Edit.ControleDeTamanhoParaDireita, Edit.ControleDeTamanhoParaEsquerda |
| Alt+Shift+seta para cima (ou seta para baixo) | Selecionar vários conjuntos de cursores | Edit.AumentarColunaParaCima, Edit.AumentarColunaParaBaixo |