Método Application.Replace (Project)

Pesquisa um valor não filtrado e substitui-lo com o valor especificado.

Sintaxe

expressão. Substituir (Campo, Teste, Valor, Substituição, SubstituirAll, Próximo, MatchCase, FieldID, TestID)

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

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 caracteres de comparação.
Valor	Opcional	Variantes	O valor a ser comparado com o valor do campo especificado em Campo.
Replacement	Opcional	Variantes	Use "" (uma cadeia de caracteres vazia) para limpar Campo onde ele atende ao teste especificado por Teste e Valor.
ReplaceAll	Opcional	Variantes	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	Variantes	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	Variantes	True se a pesquisa diferencia maiúsculas de minúsculas. O valor padrão é False.
FieldID	Opcional	Variantes	O número de identificação de campo pode ser uma das constantes PjField . FieldID tem precedência sobre qualquer valor Field.
Testid	Opcional	Variantes	O número de identificação de teste pode ser uma das constantes PjComparison . TestID tem precedência sobre qualquer valor Test.

Cadeias de caracteres 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 Valor.

Valor de retorno

Boolean

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

Comentários

Usando o método Substituir sem argumentos ou sem especificar Campo, Teste e Valor, exibe a caixa de diálogo Substituir que tem opções definidas para o estado anterior.

Para substituir um valor em todos os campos disponíveis, use o método ReplaceEx.

Exemplo

Cada instrução no exemplo a seguir abaixa a prioridade de todas as tarefas que são iguais ou superiores à prioridade 800 até a prioridade 600.

Sub LowerPriority() 
    Replace Field:="Priority", Test:="is greater than or equal to", Value:="800", _ 
        Replacement:="600", ReplaceAll:=True 
    Replace Field:="xx", Test:="xx", FieldID:=pjTaskPriority, TestID:=pjCompareGreaterThanOrEqual, _ 
        Value:="800", Replacement:="600" 
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.