CDaoRecordset::Seek

Článek
06/10/2015

Volání funkce tohoto člena k vyhledání záznamu v objektu recordset typ indexovaná tabulka, která splňuje zadaná kritéria pro aktuální index a zkontrolujte, zda záznam aktuálního záznamu.

BOOL Seek( 
   LPCTSTR lpszComparison, 
   COleVariant* pKey1, 
   COleVariant* pKey2 = NULL, 
   COleVariant* pKey3 = NULL  
); 
BOOL Seek( 
   LPCTSTR lpszComparison, 
   COleVariant* pKeyArray, 
   WORD nKeys  
);

Parametry

lpszComparison
Jedním z následujících výrazů řetězec: "<", "< =", "=" "> =", nebo ">".
pKey1
Ukazatel COleVariant jejichž hodnota odpovídá na první pole indexu.Povinné.
pKey2
Ukazatel COleVariant jejichž hodnota odpovídá druhé pole indexu, pokud existuje.Výchozí NULL.
pKey3
Ukazatel COleVariant jejichž hodnota odpovídá třetí pole v indexu a případné.Výchozí NULL.
pKeyArray
Ukazatele na matici varianty.Počet polí v indexu odpovídá velikost pole.
nKeys
Celé číslo odpovídající velikost pole, což je počet polí v indexu.

[!POZNÁMKA]

Nezadávejte zástupné znaky v klíčích.Zástupné znaky způsobí Seek žádné odpovídající záznamy.

Vrácená hodnota

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

Poznámky

Druhá verze (matice) Seek zpracování indexy polí čtyři nebo více.

SeekUmožňuje vysoce výkonné indexu hledání v tabulce Typ sady záznamů.Je nutné nastavit aktuální index voláním SetCurrentIndex před voláním Seek .Pokud index označuje duplicitní klíčové pole nebo polí, Seek vyhledá první záznam, který splňuje kritéria.Pokud nenastavíte indexu, je k vyvolání výjimky.

Všimněte si, že nejsou vytváření záznamů UNICODE, COleVariant objekty musí být explicitně deklarovány ANSI.This can be done by using the COleVariant::COleVariant( lpszSrc**,** vtSrc ) form of constructor with vtSrc set to VT_BSTRT (ANSI) or by using the COleVariant function SetString( lpszSrc**,** vtSrc ) with vtSrc set to VT_BSTRT.

Při volání Seek , předat jednu nebo více hodnot klíčů a operátor porovnání ("<", "< =", "=" "> =", nebo ">").SeekProhledá zadaná pole klíče a vyhledá první záznam, který splňuje kritéria zadaná lpszComparison a pKey1 .Jednou nalezen, Seek vrátí nenulovou hodnotu a provádí aktuálního záznamu.Pokud Seek nezdaří vyhledat odpovídající, Seek vrátí nulu a aktuální záznam nedefinovaná.Přímo pomocí objektu DAO, je nutné zaškrtnout vlastnost NoMatch explicitně.

Pokud lpszComparison je "=" "> =", nebo ">", Seek začátku index.Pokud lpszComparison je "<" nebo "< =", Seek začíná na konci indexu a hledá zpětně, pokud jsou na konci indexu duplicitní položky.V tomto případě Seek začíná libovolné položky mezi položky rejstříku duplicitní na konci indexu.

Zde nemusí být aktuální záznam při použití Seek .

Vyhledání záznamu v typ dynaset nebo záznamů typu snímek, který splňuje určité podmínky, pomocí operací hledání.Všechny záznamy, nikoli pouze ty, které splňují určitou podmínku, pomocí operace přesunu mezi záznamy.

Nelze volat Seek na připojené tabulky všech zadejte protože připojené tabulky musí být otevřen jako typ dynaset nebo snímek typ sady záznamů.Však při volání CDaoDatabase::Open přímo otevřít Instalovatelné součásti databáze ISAM, volání Seek tabulek v databázi, přestože může být výkon zpomalit.

Související informace naleznete v tématu "Hledají způsob" v nápovědě DAO.