Compartilhar via


Substituir nos Arquivos

Substituir em Arquivos permite que você pesquise o código de um conjunto de arquivos especificado para uma cadeia de caracteres ou expressão e altere algumas ou todas as correspondências encontradas.

Captura de tela da caixa de diálogo Localizar e Substituir no Visual Studio. A guia Substituir em Arquivos está aberta.

Você pode usar qualquer um dos métodos a seguir para exibir Substituir em Arquivos na janela Localizar e Substituir . Você também pode usar Ctrl+Shift+H.

Para exibir Substituir nos Arquivos

  • Pressione Ctrl+Q e insira substituir na caixa de pesquisa na parte superior da tela. Clique duas vezes em Substituir nos Arquivos na lista de resultados.

    — ou —

  • No menu Editar , selecione Localizar e Substituir e, em seguida, selecione Substituir em Arquivos.

    — ou —

  • Se a janela Localizar e Substituir já estiver aberta, selecione a guia Substituir em Arquivos .

Observação

A ferramenta Localizar e Substituir não pesquisa pastas que têm os atributos Hidden ou System.

As opções Substituir em Arquivos são quase idênticas às opções na caixa de diálogo Localizar em Arquivos . Dependendo da versão do Visual Studio que você usa, pode haver mais opções de substituição disponíveis na caixa de diálogo, conforme descrito nas seções a seguir.

Caixa Substituir

Para substituir instâncias da cadeia de caracteres na caixa Localizar por outra cadeia de caracteres, insira a cadeia de caracteres de substituição na caixa Substituir . Para excluir instâncias da cadeia de caracteres na caixa Localizar , deixe a caixa Substituir em branco. Selecione a seta suspensa na caixa Localizar para exibir as cadeias de caracteres que você pesquisou mais recentemente. Marque a caixa de seleção para Expressões regulares do usuário e selecione o botão Substituir Construtor de Expressões adjacente se desejar usar uma ou mais expressões regulares na string de substituição. Para obter mais informações, consulte Usar expressões regulares no Visual Studio.

Preservar maiúsculas e minúsculas

Durante uma operação de substituição, é possível preservar a capitalização original de cada correspondência em seu código. Ative e desative a preservação da capitalização usando a opção Preservar Maiúsculas e Minúsculas (Alt+V). Essa opção está disponível no Visual Studio 2022 versão 17.8 ou posterior.

Para preservar o Pascal case ou Camel case, sua cadeia de caracteres de substituição também deve estar em Pascal case ou Camel case. As maiúsculas e minúsculas também são preservadas em texto que contém hifens ou sublinhados.

Aqui estão alguns exemplos:

  • Substituir "begin" por "end" transformará "Begin" em "End" e "BEGIN" em "END".

  • Substituir "onetwothree" por "fourFiveSix" transformará "onetwothree" em "fourfivesix", "oneTwoThree" em "fourFiveSix" e "OneTwoThree" em "FourFiveSix".

Observação

A partir do Visual Studio 2022, para otimizar o desempenho da pesquisa, resultados parciais, como resultados de arquivos pré-indexados, são mostrados antes que os resultados finais estejam disponíveis. No entanto, quando você executa operações de substituição, esse benefício de desempenho não se aplica porque as operações de substituição são iniciadas somente depois que os resultados completos da pesquisa são retornados.