CDaoRecordset::FindFirst

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

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

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

Параметры

lpszFilter

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

Примечания

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

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

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

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

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

Найти операции Начать Направление поиска
FindFirst Начало набора записей Конец набора записей
FindLast Конец набора записей Начало набора записей
FindNext Текущая запись Конец набора записей
FindPrevious Текущая запись Начало набора записей

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

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

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

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

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

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

Index