Метод Application.ReplaceEx (Project)

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

Синтаксис

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

Выражение Выражение, возвращающее объект 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 .
SearchAllFields	Необязательный	Variant	Если задано значение True, замените указанное значение во всех доступных полях. Значение по умолчанию — False. SearchAllFields имеет приоритет над Field и FieldID.

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

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

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

Boolean

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

Замечания

При использовании метода ReplaceEx без аргументов или без указания поля, теста и значения отображается диалоговое окно Заменить с параметрами, заданными для предыдущего состояния. Если для параметра SearchAllFields заданозначение True, для программного использования по-прежнему требуются значения параметров Field, Test и Value .

Пример

Любая строка в следующем примере заменяет "Bad" на "Хорошо" в наборе всех доступных полей.

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

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

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