Метод Find (ADO)
Область применения: Access 2013, Office 2013
Выполняет поиск строки, удовлетворяющей заданным условиям, в наборе записей . При необходимости можно указать направление поиска, начальную строку и смещение от начальной строки. Если условие выполнено, текущая позиция строки устанавливается для найденной записи; В противном случае для позиции устанавливается конец (или начало) набора записей.
Синтаксис
Find (Criteria, SkipRows, SearchDirection, Start)
Параметры
| Параметр | Описание |
|---|---|
| Criteria | Строковое значение, содержащее инструкцию, указывающую имя столбца, оператор сравнения и значение для использования в поиске. |
| SkipRows | Необязательный параметр. Значение Long , значение по умолчанию которого равно нулю, указывающее смещение строки по сравнению с текущей строкой или начальной закладкой для начала поиска. По умолчанию поиск начинается в текущей строке. |
| SearchDirection | Необязательный параметр. Значение SearchDirectionEnum , указывающее, должен ли поиск начинаться в текущей строке или в следующей доступной строке в направлении поиска. Неудачный поиск останавливается в конце набора записей , если значением является adSearchForward. Неудачный поиск останавливается в начале набора записей , если значением является adSearchBackward. |
| Start | Необязательный параметр. Закладка Variant , которая выступает в качестве начальной позиции для поиска. |
Замечания
В критериях можно указать только имя одного столбца. Этот метод не поддерживает поиск по нескольким столбцам.
Оператор сравнения в критериях может быть ">" (больше), "<" (меньше чем), "=" (равно), ">=" (больше или равно), "<=" (меньше или равно), "<>" (не равно) или "нравится" (сопоставление шаблонов).
Значение в критериях может быть строкой, числом с плавающей запятой или датой. Строковые значения разделяются одними кавычками или знаками "#" (числовой знак) (например, "state = "WA" или "state = #WA#"). Значения даты разделяются знаками "#" (числовой знак) (например, "start_date > #22/97#") и могут содержать часы, минуты и секунды для указания меток времени, но не должны содержать миллисекунд или ошибки будут возникать.
Если оператор сравнения имеет значение like, строковое значение может содержать звездочку (*) для поиска одного или нескольких вхождений любого символа или подстроки. Например, "состояние, как "M*"" соответствует штату Мэн и Массачусетс. Вы также можете использовать начальные и конечные звездочки для поиска подстроки, содержащейся в значениях. Например, "состояние, подобное "*as*"" соответствует Аляске, Арканзасу и Массачусетсу.
Звездочки можно использовать только в конце строки условия или вместе в начале и в конце строки условия, как показано выше. Звездочка не может использоваться в качестве подстановочного знака ('*str') или встроенного подстановочного знака ('s*r'). Это приведет к ошибке.
Примечание.
Если текущее положение строки не задано перед вызовом Find, возникнет ошибка. Любой метод, задающий позицию строки, например MoveFirst, должен вызываться перед вызовом метода Find.
Примечание.
Если вы вызовете метод Find для набора записей, а текущая позиция в наборе записей находится в последней записи или конце файла (EOF), вы ничего не найдете. Необходимо вызвать метод MoveFirst , чтобы задать текущую позицию или курсор в начале набора записей.