Sdílet prostřednictvím


CDaoRecordset::FindFirst

Volání této členské funkce vyhledat první záznam, který splňuje zadané podmínky.

BOOL FindFirst( 
   LPCTSTR lpszFilter  
);

Parametry

  • lpszFilter
    Řetězcový výraz (stejně jako kde klauzule v příkazu SQL bez slova kde) slouží k vyhledání záznamu.

Vrácená hodnota

Nenulová hodnota, pokud jsou nalezeny odpovídající záznamy, jinak 0.

Poznámky

FindFirst Členské funkce zahájí hledání od začátku sady záznamů a vyhledávání na konci záznamů.

Pokud chcete zahrnout všechny záznamy v hledání (nikoli pouze ty, které splňují určitou podmínku) pomocí jedné operace přesunutí přesuňte od záznamu k záznamu.Vyhledání záznamu v tabulce typ záznamů, zavolejte Seek členské funkce.

Pokud není umístěn záznam odpovídající kritériím, je aktuální záznam ukazatele neurčeného, a FindFirst vrátí hodnotu 0.Pokud sadu záznamů obsahuje více než jeden záznam, který splňuje kritéria, FindFirst nalezne první výskyt FindNext vyhledá další výskyt atd.

Poznámka k upozorněníUpozornění

Pokud upravíte aktuální záznam, nezapomeňte uložit změny voláním aktualizace členské funkce před přesunem do jiného záznamu.Přesunutí na další záznam bez aktualizace změn bez upozornění ztraceny.

Najít členské funkce hledání z umístění a ve směru uvedené v následující tabulce:

Operace hledání

Začít

Směr hledání

FindFirst

Začátek sady záznamů

Konce sady záznamů

FindLast

Konce sady záznamů

Začátek sady záznamů

FindNext

Aktuální záznam

Konce sady záznamů

FindPrevious by

Aktuální záznam

Začátek sady záznamů

[!POZNÁMKA]

Při volání FindLast , databázový stroj Microsoft Jet zcela naplní vaši sadu záznamů před zahájením vyhledávání, to ještě nestalo.První hledání může trvat déle než dalších hledáních.

Pomocí jedné operace hledání není stejný jako volací MoveFirst nebo MoveNext , však které jednoduše vytvoří první nebo další záznam aktuální bez určení podmínku.Můžete provést operaci hledání pomocí operace přesunutí.

Při operacích hledání pomocí si pamatujte následující pravidla:

  • Pokud Najít vrátí nenulovou aktuální záznam není definována.V tomto případě je třeba umístit ukazatel aktuální záznam zpět na platný záznam.

  • Operace hledání nelze použít s možností posouvání pouze pro předávání objektu recordset typu snímek.

  • Je vhodné použít u.s. formát Datum (měsíc den rok) při vyhledávání polí obsahujících data, i když nepoužíváte u.s. verzi databázového stroje Microsoft Jet; v opačném případě se odpovídající záznamy nemusí být nalezen.

  • Při práci s databází ODBC a velké dynamické sady, můžete zjistit, že použití operací hledání je pomalá, zejména při práci s velkými sadami.Pomocí dotazů SQL může zlepšit výkon s vlastní pořadípodle nebo kde doložky, parametrické dotazy nebo CDaoQuerydef objekty, které načtení určitých indexovaných záznamů.

Související informace naleznete v tématu "FindFirst FindLast, NajítDalší metody FindPrevious by" v nápovědě DAO.

Požadavky

Záhlaví: afxdao.h

Viz také

Referenční dokumentace

Třída CDaoRecordset

Graf hierarchie

CDaoRecordset::Find

CDaoRecordset::FindLast

CDaoRecordset::FindNext

CDaoRecordset::FindPrev