CDaoRecordset::FindFirst

BOOL FindFirst (LPCTSTR lpszFilter);
rzut (CDaoException, CMemoryException);

Wartość zwracany

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

Parametry

lpszFilter

Wyrażenie tekstowe (takie jak klauzuli WHERE w instrukcji SQL bez wyrazu, w którym) używane do zlokalizowania rekordu.

Uwagi

Wywołanie tej funkcji Państwa do znalezienia pierwszego rekordu, który odpowiada określony warunek. Funkcja Członkowskie FindFirst rozpoczyna wyszukiwanie od początku zestawu rekordów i wyszukiwania na końcu zestawu rekordów.

Jeśli chcesz dołączyć wszystkich rekordów w kwerendzie wyszukiwania (nie tylko tych, które spełniają określony warunek) skorzystać z jednej z operacji przenoszenia do przenoszenia między rekordami. Aby zlokalizować rekord w zestawie rekordów typu tabela, wywołania funkcji członek Seek.

Jeżeli nie znajduje się rekordów spełniających kryteria, bieżący wskaźnik 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, ZnajdYNastępny lokalizuje następne wystąpienie itd.

Przestroga   Jeśli edytujesz bieżący rekord, należy pamiętać o zapisywaniu zmian przez wywołanie funkcji członek aktualizacji , zanim zostanie przeniesiony do innego rekordu. Jeśli zostanie przeniesiony do innego rekordu bez aktualizowania, zmiany zostaną utracone bez ostrzeżenia.

Funkcje składowe znaleźć wyszukiwania z lokalizacji i w kierunku określonego w poniższej tabeli:

Waż&nenbsp;  Podczas wywoływania FindLast, aparat bazy danych Microsoft Jet całkowicie wypełnia swój zestaw rekordów przed rozpoczęciem wyszukiwania, jeżeli to nie zostało już wykonane. Pierwszego wyszukiwania może trwać dłużej niż kolejne wyszukiwanie.

Za pomocą jednej operacji znajdowania nie jest taki sam, jak wywoływanie MoveFirst lub MoveNext, jednak co po prostu czyni pierwszego lub następnego rekordu bieżącego bez określania warunku. Można wykonać operację wyszukiwania z operacji przenoszenia.

Pamiętać następujące przy użyciu operacji znajdowania:

• Jeśli znaleźć zwraca wartość różną od zera, bieżący rekord nie jest zdefiniowana. W takim przypadku należy umieocić bieżący wskaźnik rekordu Wróć do rekordu ważne.
  
  
• Znajdowanie danych nie można używać tylko do przodu przewijania typu migawka rekordów.
  
  
• Należy używać formatu daty U.S. (miesiąc dzień rok) podczas wyszukiwania dla pól zawierających daty, nawet jeśli nie jest używana amerykańska wersja aparatu bazy danych Microsoft Jet; w przeciwnym razie pasujących rekordów nie można znaleźć.
  
  
• Podczas pracy z baz danych ODBC i duże zestawy dynamiczne, może odkryć, że za pomocą operacji znajdowania jest powolne, szczególnie podczas pracy z dużymi zestawy rekordów. Można poprawić wydajność, przy użyciu kwerendy z niestandardowych klauzul ORDER BY lub gdy SQL, kwerendy parametryczne lub obiektów CDaoQuerydef , pobierające określonych rekordów indeksowanych.

Aby uzyskać więcej informacji na temat znajdowania rekordów, zobacz artykuł zestawu rekordów DAO: nawigacji zestawu rekordów w Visual C++ Programmer's Guide. Aby uzyskać pokrewne informacje zobacz temat „FindFirst, FindLast, ZnajdYNastępny, FindPrevious metody"w pomocy DAO.

Omówie&nie CDaoRecordset |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CDaoRecordset::Find, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev