Método Range.Replace (Excel)

Retorna um Boolean que indica caracteres em células dentro do intervalo especificado. O uso deste método não altera a seleção ou a célula ativa.

Sintaxe

expressão. Substituir (O quê, Substituição, LookAt, SearchOrder, MatchCase, MatchByte, SearchFormat, ReplaceFormat)

expressão Uma variável que representa um objeto de Intervalo.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
What	Obrigatório	Variantes	A cadeia de caracteres que você deseja que o Microsoft Excel pesquise.
Replacement	Obrigatório	Variant	A cadeia de caracteres de substituição.
LookAt	Opcional	Variant	Pode ser uma das seguintes XlLookAt constantes: xlWhole ou xlPart.
SearchOrder	Opcional	Variant	Pode ser uma das seguintes XlSearchOrder constantes: xlByRows ou xlByColumns.
MatchCase	Opcional	Variantes	True para tornar fazer com que a pesquisa passe a diferenciar maiúsculas de minúsculas.
MatchByte	Opcional	Variantes	Use esse argumento somente se você tiver selecionado ou instalado suporte de idioma de bytes duplos no Microsoft Excel. True para que os caracteres de byte duplo correspondam apenas aos caracteres de byte duplo. False para que os caracteres de byte duplo correspondam aos seus equivalentes de byte único.
SearchFormat	Opcional	Variant	O formato de pesquisa para o método.
ReplaceFormat	Opcional	Variant	O formato de substituição para o método.

Valor de retorno

Booliano

Comentários

As configurações de LookAt, SearchOrder, MatchCase e MatchByte são salvas sempre que você usa esse método. Se você não especificar valores para esses argumentos na próxima vez que chamar o método, os valores salvos serão usados. Definir esses argumentos alterará as configurações na caixa de diálogo Find e, ao alterar as configurações na caixa de diálogo Find, os valores salvos que são usados se você omitir os argumentos serão alterados. Para evitar problemas, defina esses argumentos explicitamente sempre que você usar esse método.

Exemplo

Este exemplo substitui todas as ocorrências da função trigonométrica SIN pela função COS. O intervalo de substituição é a coluna A da Planilha1.

Worksheets("Sheet1").Columns("A").Replace _ 
 What:="SIN", Replacement:="COS", _ 
 SearchOrder:=xlByColumns, MatchCase:=True

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.