Метод 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 и обратная связь.