Метод Application.Replace (Project)

Статья
04/07/2023

Выполняет поиск нефильтрованного значения и заменяет его указанным значением.

Синтаксис

expression. Replace (Field, Test, Value, Replace, ReplaceAll, Next, MatchCase, FieldID, TestID)

выражение: переменная, представляющая объект Application.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Field	Необязательный	String	Имя поля для поиска.
Test	Необязательный	String	Тип сравнения между полем и значением. Может быть одной из строк сравнения.
Value (Значение)	Необязательный	Variant	Значение для сравнения со значением поля, указанного в поле Поле.
Replacement	Необязательный	Variant	Используйте "" (пустую строку), чтобы очистить поле , в котором оно соответствует тесту, указанному в параметрах Test и Value.
ReplaceAll	Необязательный	Variant	Значение true , если все вхождения значения заменены. False, если заменяется только первое вхождение. Значение по умолчанию — False.
Next	Необязательный	Variant	Значение true, если Project выполняет поиск следующего вхождения соответствующих условий поиска. False, если Project ищет следующее вхождение. Значение по умолчанию — True.
MatchCase	Необязательный	Variant	Значение True , если в поиске учитывается регистр. Значение по умолчанию — False.
FieldID	Необязательный	Variant	Идентификационный номер поля может быть одной из констант PjField . FieldID имеет приоритет над любым значением Поля .
TestID	Необязательный	Variant	Тестовый идентификационный номер может быть одной из констант PjComparison . TestID имеет приоритет над любым значением Test .

Строки сравнения

Строка сравнения	Описание
"равно"	Значение Поля равно Значению.
"не равно"	Значение Поля не равно Значению.
"больше, чем"	Значение Поля больше значения Value.
"больше или равно"	Значение Поля больше или равно Значению.
"меньше, чем"	Значение Поля меньше значения Value.
значение "меньше или равно"	Значение Поля меньше или равно значению Value.
"is within"	Значение Поля находится в значении Value.
"не внутри"	Значение Field не находится в значении Value.
"contains"	Поле содержит значение.
"не содержит"	Поле не содержит значение.
"содержит точно"	Поле содержит точно значение.

Возвращаемое значение

Boolean

Значение true , если производится какая-либо замена; в противном случае — False.

Замечания

При использовании метода Replace без аргументов или без указания поля, теста и значения отображается диалоговое окно Заменить с параметрами, заданными для предыдущего состояния.

Чтобы заменить значение во всех доступных полях, используйте метод ReplaceEx .

Пример

Любой оператор в следующем примере понижает приоритет всех задач, равных или более 800, до приоритета 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

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.