Метод Range.Replace (Excel)

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

Синтаксис

выражение. Заменить (What, Replacement, 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 на листе Лист1.

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

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

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