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.

Применяется к