CDaoRecordset::FindFirst

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich wyszukiwanie pierwszego rekordu, który odpowiada określony warunek.

BOOL FindFirst(
   LPCTSTR lpszFilter 
);

Parametry

lpszFilter
Wyrażenie tekstowe (jak gdzie w instrukcji SQL bez wyrazu klauzuli gdzie) używane do zlokalizowania rekordu.

Wartość zwracana

Niezerowa, jeśli znaleziono pasujących rekordów, inaczej 0.

Uwagi

FindFirst Członkowskich funkcja rozpoczyna wyszukiwanie od początku zestawu rekordów i wyszukiwania na końcu zestawu rekordów.

Jeśli chcesz uwzględnić wszystkie rekordy w wyszukiwaniu (nie tylko tych, które spełniają określony warunek), użyj jednej z operacji przenoszenia do przechodzenia między rekordami.Do znajdowania rekordów w zestawie rekordów z tabeli typ, call Seek funkcji składowej.

Jeśli nie jest umieszczony rekord, spełniających kryteria, wskaźnik bieżącego rekordu jest nieokreślony, i FindFirst zwraca wartość zero.Jeśli zestaw rekordów zawiera więcej niż jeden rekord, który spełnia kryteria, FindFirst lokalizuje pierwszego wystąpienia FindNext znajduje następne wystąpienie i tak dalej.

Przestroga
Jeśli bieżący rekord można edytować, należy zapisać zmiany, wywołując Aktualizacja Członkowskich funkcji przed przeniesieniem do innego rekordu.Przenieść do innego rekordu bez aktualizowania, zmiany zostaną utracone bez ostrzeżenia.

Znaleźć Członkowskich funkcje wyszukiwania z lokalizacji i w kierunku określonego w poniższej tabeli:

Operacje znajdowania	Rozpoczęcie	Kierunek wyszukiwania
FindFirst	Początek zestawu rekordów	Koniec zestawu rekordów
FindLast	Koniec zestawu rekordów	Początek zestawu rekordów
FindNext	Bieżący rekord	Koniec zestawu rekordów
FindPrevious	Bieżący rekord	Początek zestawu rekordów

[!UWAGA]

Po wywołaniu FindLast, aparat bazy danych Microsoft Jet całkowicie wypełnia swój zestaw rekordów przed rozpoczęciem wyszukiwania, jeśli nie ma to już zrobione.Pierwszy wyszukiwania może trwać dłużej niż kolejnych wyszukiwań.

Za pomocą jednej operacji wyszukiwania nie jest tym samym telefonicznej MoveFirst lub MoveNext, które po prostu udostępnia jednak pierwszego lub następnego rekordu bieżącego bez określania warunku.Można wykonać operacji wyszukiwania z operacji przenoszenia.

Podczas korzystania z operacji wyszukiwania, należy pamiętać o następujących:

Jeśli znaleźć zwraca wartość niezerową, bieżący rekord nie jest zdefiniowany.W takim przypadku należy umieścić bieżącego wskaźnika rekordu do rekordu prawidłowy.
Nie można używać operacji znajdowania przewijanego typu migawka rekordów.
Należy używać u.s. format daty (rok miesiąc dzień) podczas wyszukiwania dla pól zawierających daty, nawet jeśli nie używasz u.s. wersja aparatu bazy danych Microsoft Jet; w przeciwnym razie pasujących rekordów nie może być znaleziony.
Podczas pracy z bazami danych ODBC i duże zestawy dynamiczne, można wykryć, że przy użyciu operacji Znajdź jest powolne, zwłaszcza podczas pracy z dużych zestawów rekordów.Można poprawić wydajność przy użyciu kwerend SQL z dostosowanej zamówieniaprzez lub gdzie klauzule, parametr kwerendy, lub CDaoQuerydef obiektów, które pobrania określonych rekordów indeksowanych.

Powiązanych informacji zobacz temat "ZnajdźNastępny FindFirst, FindLast, FindPrevious metod" w pomocy DAO.