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 que, Substituição, LookAt, SearchOrder, MatchCase, MatchByte, SearchFormat, ReplaceFormat, FormulaVersion)

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	Variant	A cadeia que pretende que o Microsoft Excel procure.
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	Variant	Utilize este argumento apenas se tiver selecionado ou instalado suporte de idioma de byte duplo 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.
FormulaVersion	Opcional	Variant	Determina se deve substituir nas constantes de estado da fórmula de Matriz Dinâmica: xlReplaceFormula ou xlReplaceFormula2.

Valor de retorno

Booliano

Comentários

As definições de LookAt, SearchOrder, MatchCase e MatchByte são guardadas sempre que utilizar este 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 estes argumentos explicitamente sempre que utilizar este 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.