Range.Find Метод

Определение

Пространство имен:

Microsoft.Office.Interop.Excel

Сборка:

Microsoft.Office.Interop.Excel.dll

Находит определенную информацию в диапазоне и возвращает Range объект, представляющий первую ячейку, в которой находятся эти сведения.

public Microsoft.Office.Interop.Excel.Range Find (object What, object After, object LookIn, object LookAt, object SearchOrder, Microsoft.Office.Interop.Excel.XlSearchDirection SearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, object MatchCase, object MatchByte, object SearchFormat);

Public Function Find (What As Object, Optional After As Object, Optional LookIn As Object, Optional LookAt As Object, Optional SearchOrder As Object, Optional SearchDirection As XlSearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, Optional MatchCase As Object, Optional MatchByte As Object, Optional SearchFormat As Object) As Range

Параметры

What

Object

Обязательный объект. Искомые данные. Может быть строкой или любым типом данных Microsoft Excel.

After

Object

Необязательный объект. Ячейка, после которой нужно начать поиск. Соответствует положению активной ячейки, когда поиск выполняется из пользовательского интерфейса. Обратите внимание, что After должна быть одной ячейкой в диапазоне. Помните, что поиск начинается after с этой ячейки. В указанной ячейке не выполняется поиск до тех пор, пока метод не переключится обратно в эту ячейку. Если этот аргумент не указан, поиск начинается после ячейки в левом верхнем углу диапазона.

LookIn

Object

Необязательный объект. Тип сведений.

LookAt

Object

Необязательный объект. Может быть одной из следующих XlLookAt констант: xlWhole или xlPart.

SearchOrder

Object

Необязательный объект. Может быть одной из следующих XlSearchOrder констант: xlByRows или xlByColumns.

SearchDirection

XlSearchDirection

Необязательный параметр XlSearchDirection. Направление поиска. Может быть одной из следующих констант XlSearchDirection:xlNextdefaultxlPrevious

MatchCase

Object

Необязательный объект. Значение true , чтобы сделать регистр поиска конфиденциальным. Значение по умолчанию — False.

MatchByte

Object

Необязательный объект. Используется только в том случае, если вы выбрали или установили поддержку двухбайтового языка. Значение true , если двухбайтовые символы соответствуют только двухбайтовым символам; Значение false , чтобы двухбайтовые символы соответствовали их однобайтовым эквивалентам.

SearchFormat

Object

Необязательный объект. Формат поиска.

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

Range

Комментарии

Этот метод возвращает значение Nothing, если совпадения не найдены.

Этот метод не влияет на выделение или активную ячейку.

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

Для повторения FindNext(Object) поиска можно использовать методы и FindPrevious(Object) .

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

Чтобы найти ячейки, отвечающие более сложным шаблонам, используйте инструкцию For Each...Next с оператором Like.