Метод Range.Replace (Excel)

Возвращает логическое значение, указывающее символы в ячейках в указанном диапазоне. Использование этого метода не изменяет ни выделение, ни активную ячейку.

Синтаксис

expression. Replace (What, Replace, LookAt, SearchOrder, MatchCase, MatchByte, SearchFormat, ReplaceFormat, FormulaVersion)

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
What	Обязательный	Variant	Строка, которую требуется найти в Microsoft Excel.
Replacement	Обязательный	Variant	Строка замены.
LookAt	Необязательный	Variant	Может быть одной из следующих констант XlLookAt: xlWhole или xlPart.
SearchOrder	Необязательный	Variant	Может быть одной из следующих констант XlSearchOrder: xlByRows или xlByColumns.
MatchCase	Необязательный	Variant	Значение True, чтобы выполнять поиск с учетом регистра.
MatchByte	Необязательный	Variant	Используйте этот аргумент только в том случае, если вы выбрали или установили поддержку двухбайтового языка в Microsoft Excel. Значение True, чтобы двухбайтовые символы сопоставлялись только с двухбайтовым символами. Значение False, чтобы двухбайтовые символы сопоставлялись с однобайтовыми эквивалентами.
SearchFormat	Необязательный	Variant	Формат поиска для метода .
ReplaceFormat	Необязательный	Variant	Формат замены для метода .
FormulaVersion	Необязательный	Variant	Определяет, следует ли заменить в динамическом массиве константы состояния формулы: xlReplaceFormula или xlReplaceFormula2.

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

Boolean

Примечания

Параметры lookAt, SearchOrder, MatchCase и MatchByte сохраняются при каждом использовании этого метода. Если не указать значения этих аргументов при следующем вызове метода, будут использоваться сохраненные значения. Установка этих аргументов изменяет параметры в диалоговом окне Найти, а изменение параметров в диалоговом окне Найти приводит к изменению сохраненных значений, которые используются, если опустить аргументы. Чтобы избежать проблем, явно устанавливайте эти аргументы при каждом использовании этого метода.

Пример

В этом примере каждое вхождение тригонометрической функции SIN заменяется функцией COS. Диапазон замены — это столбец A на листе Sheet1.

Worksheets("Sheet1").Columns("A").Replace _ 
 What:="SIN", Replacement:="COS", _ 
 SearchOrder:=xlByColumns, MatchCase:=True

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

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