CDaoRecordset::FindFirst
Эта функция-член вызывается с целью найти первую запись, соответствующий заданному условию.
BOOL FindFirst(
LPCTSTR lpszFilter
);
Параметры
- lpszFilter
Строковое выражение (как предложение WHERE в инструкции SQL без слова WHERE), используемое для поиска записи.
Возвращаемое значение
Ненулевой если найдены эквивалентен записи, в противном случае – значение 0.
Заметки
Функция-член FindFirst его поиск начинается с начала набора записей и поиск в конец набора записей.
Если необходимо включить все записи в поиске (а не только те, удовлетворяющих определенному условию) использовать одну из операций перемещения для перемещения от записи к записи. Для поиска записи в наборе записей табличного типа, вызовите функцию-член Seek.
Если запись, соответствующая критериям не найдено, то указатель текущей записи, возвращают нуль неопределённого и FindFirst. Если набор записей содержит несколько запись, которая удовлетворяет условию, FindFirst ищет первое вхождение, FindNext находит следующее вхождение и т д
Предупреждение
Если изменяется текущая запись, необходимо сохранить изменения, вызвав функцию-член Обновить прежде чем перейти к другой записи.При перемещении к другой записи без обновления, то изменения теряются без предупреждения.
Функции-члены Найти поиска местоположения и в направлении заданного в следующей таблице:
Операции поиска |
Метод Begin |
Направление поиска |
|---|---|---|
FindFirst |
Начало набора записей |
Элемент набора записей |
FindLast |
Элемент набора записей |
Начало набора записей |
FindNext |
Текущая запись |
Элемент набора записей |
FindPrevious |
Текущая запись |
Начало набора записей |
Примечание
При вызове FindLast ядро СУБД Microsoft jet полностью заполняет набор записей до начала поиска, если это еще не сделано.Первый поиск может занять больше времени, чем последующие операции поиска.
С использованием одной из операций поиска, не совпадает с вызовом MoveFirst или MoveNext, однако, просто делает первое или следующие записи текущая без указания условия. Можно проследить операции поиска с операцией перемещения.
Имейте в виду следующее при использовании операций поиска:
Если Найти возвращает ненулевое, текущая запись не указана. В этом случае необходимо поместить указатель текущей записи обратно на допустимый записи.
Нельзя использовать операцию поиска с вперед - только при необходимости выполняя прокрутку набор записей является моментальным снимок- типа.
Следует использовать формат даты (США.. ) (месяц-дн- года) при поищете для полей, содержащих даты, даже если не использовать версию США.. компонента database engine для jet (Майкрософт); в противном случае соответствующий записи не могут быть найдены.
При работе с базой данных ODBC и большими динамическими подмножествами данных, можно обнаружить, что с помощью операций найти медленно, особенно при работе с большими наборами записей. Можно повысить производительность с помощью запросов SQL с настроенным ORDERBY или предложениями WHERE, запросами с параметрами или объектами CDaoQuerydef, которые получают конкретные индексированные записи.
Дополнительные сведения см. в разделе "FindFirst, FindLast, FindNext, методы FindPrevious" в Справке DAO.
Требования
Header: afxdao.h