Método Application.ReplaceEx (Project)

Procura um valor não filtrado em um campo especificado ou em todos os campos disponíveis e o substitui com o valor especificado.

Sintaxe

expressão. ReplaceEx (Campo, Teste, Valor, Substituição, SubstituirTodos, Seguinte, MatchCase, FieldID, TestID, SearchAllFields)

expressão Uma expressão que devolve um objeto Aplicação .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Field	Opcional	String	O nome do campo a ser pesquisado.
Test	Opcional	String	O tipo de comparação feita entre Field e Value. Pode ser uma das cadeias de comparação.
Valor	Opcional	Variant	O valor a comparar com o valor do campo especificado em Campo.
Replacement	Opcional	Variant	Utilize "" (uma cadeia vazia) para limpar Campo onde cumpre o teste especificado por Teste e Valor.
SubstituirTodos	Opcional	Variant	True se todas as ocorrências da Value são substituídas. False se somente a primeira ocorrência é substituída. O valor padrão é False.
Next	Opcional	Variant	True se as pesquisas de projeto para baixo para a próxima ocorrência de correspondência de critérios de pesquisa. False se o projeto de pesquisa acima a próxima ocorrência. O valor padrão é True.
MatchCase	Opcional	Variant	True se a pesquisa diferencia maiúsculas de minúsculas. O valor padrão é False.
FieldID	Opcional	Variant	O número de identificação do campo pode ser uma das constantes de PjField . FieldID tem precedência sobre qualquer valor Field.
ID de Teste	Opcional	Variant	O número de identificação de teste pode ser uma das constantes PjComparison . TestID tem precedência sobre qualquer valor Test.
SearchAllFields	Opcional	Variant	Se For Verdadeiro, substitua o valor especificado em todos os campos disponíveis. O valor padrão é False. SearchAllFields prevalece sobre Field e FieldID.

Cadeias de comparação

Cadeia de comparação	Descrição
"é igual a"	O valor de Campo é igual ao de Valor.
"é diferente de"	O valor de Campo é diferente do de Valor.
"é maior que"	O valor de Campo é maior que o de Valor.
"é maior ou igual a"	O valor de Campo é maior ou igual ao de Valor.
"é menor que"	O valor de Campo é menor que o de Valor.
"é menor ou igual a"	O valor de Campo é menor ou igual ao de Valor.
"está contido em"	O valor de Campo está contido em Valor.
"não está contido em"	O valor de Campo não está contido em Valor.
"contém"	Campo contém valor.
"não contém"	Campo não contém valor.
"contém exatamente"	O campo contém exatamente o Valor.

Valor de retorno

Boolean

True se qualquer substituições são feitas; Caso contrário, False.

Comentários

Utilizar o método ReplaceEx sem argumentos ou sem especificar Campo, Teste e Valor, apresenta a caixa de diálogo Substituir que tem opções definidas para o estado anterior. Se definir SearchAllFields como Verdadeiro, a utilização programática ainda requer valores para os parâmetros Campo, Teste e Valor .

Exemplo

Cada linha do exemplo a seguir substitui "Bad" por "Good", dentro do conjunto de todos os campos disponíveis.

Sub Bad2Good() 
    ReplaceEx Field:="Name", Test:="contains", Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
    ReplaceEx Field:="xx", Test:="xx", TestID:=pjCompareContains, Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
End Sub

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.