CDaoRecordset::FindFirst

BOOL FindFirst (LPCTSTR lpszFilter);
броска (CDaoException, CMemoryException);

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

Ненулевое значение, если будут найдены совпадающие данные, иначе 0.

Параметры

lpszFilter

Строковое выражение (как предложение WHERE в инструкции SQL без использования самого слова где) для поиска записи.

Примечания

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

Если вы хотите включить все записи в вашем поиске (не только те, которые удовлетворяют определенному условию) использовать один из операции Move для перемещения от записи к записи. Чтобы найти записи в объекте recordset табличного типа, вызовите функцию-член Seek.

Если запись, соответствующие критериям не находится, указатель текущей записи не определены, и FindFirst возвращает ноль. Если набор записей содержит более одной записи, которые удовлетворяют критериям, FindFirst находит первое вхождение, FindNext находит следующее вхождение и т. д.

Осторожно   Если вы измените текущую запись, не забудьте сохранить изменения путем вызова функции-члена Update перед тем, как перейти к другой записи. При переходе к другой записи без обновления, изменения будут утеряны без предупреждения.

Функции-члены найти Поиск от местоположения и в направлении, указанном в следующей таблице:

Важно   При вызове FindLast, базы данных Microsoft Jet полностью заполняет набор записей перед началом поиска, если это уже сделано не было. Первый Поиск может занять больше времени, чем последующие поиски.

С помощью одного из операций поиска не является таким же, как вызов MoveFirst или MoveNext, однако, что просто делает первый или следующую запись текущей без указания условие. Вы можете последовать за операции поиска с операции перемещения.

Помнить следующее при использовании операций поиска:

• Если Поиск возвращает ненулевое значение, текущая запись не определен. В этом случае необходимо поместить указатель текущей записи обратно в допустимую запись.
  
  
• Операция поиска нельзя использовать с последовательным доступом прокрутки записей статического типа.
  
  
• Следует использовать формат даты США (месяц день год) при поиске для полей, содержащих даты, даже если вы не используете версии США Microsoft Jet database engine; в противном случае соответствие записей может быть не найдена.
  
  
• При работе с базами данных ODBC и большие динамические подмножества данных, вы можете обнаружить, что с помощью операции поиска медленно, особенно при работе с большой набор записей. Можно повысить производительность, используя SQL запросы с заказной порядок BY или где предложений, запросы с параметрами или CDaoQuerydef объекты, получить индексированные записи.

Для получения дополнительных сведений о поиске записей, см. статью записей DAO: навигации набора записей в Руководстве по Visual C++ программист. Соответствующую информацию в разделе «FindFirst, FindLast, FindNext, FindPrevious методы» в справке DAO.

Обзор CDaoRecordset |  Члены класса | Иерархическая схема

См. такжеnbsp;CDaoRecordset::Find, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev