CDaoRecordset::FindFirst

Chiamare la funzione membro per cercare il primo record corrispondente a una determinata condizione.

BOOL FindFirst(
   LPCTSTR lpszFilter 
);

Parametri

  • lpszFilter
    Un'espressione stringa come la clausola where in un'istruzione SQL senza la parola where) utilizzata per individuare il record.

Valore restituito

Diverso da zero se i record corrispondenti vengono trovati, altrimenti 0.

Note

La funzione membro FindFirst inizia la ricerca dall'inizio del recordset e trova alla fine del recordset.

Se si desidera includere tutti i record nel non solo quelli che soddisfano una specifica condizione) utilizzo di una delle operazioni di spostamento spostarsi da un record a un altro.Per individuare un record in un recordset di tipo tabella, chiamare la funzione membro Seek.

Se una corrispondenza record i criteri non viene individuata, il puntatore del record corrente è restituisce zero FindFirst e imprevisti.Se il recordset contiene più record che soddisfano i criteri, FindFirst individuare la prima occorrenza, FindNext individuare l'occorrenza successiva, e così via.

Nota di avvisoAttenzione

Se si modifica il record corrente, assicurarsi di salvare le modifiche chiamando la funzione membro Aggiorna prima di muoviate a un altro record.Se si passa a un altro record senza aggiornare, le modifiche vengono perse senza avviso.

Le funzioni membro Trova cerca la posizione e nella direzione specificata nella tabella seguente:

Operazioni di ricerca

Begin

Direzione di ricerca

FindFirst

Avvio del recordset

Fine del recordset

FindLast

Fine del recordset

Avvio del recordset

FindNext

Record corrente

Fine del recordset

FindPrevious

Record corrente

Avvio del recordset

[!NOTA]

Quando si chiama FindLast, il modulo di gestione di database Microsoft Jet completamente popola il recordset prima di iniziare la ricerca, se questo non è già stato eseguito.La prima ricerca può richiedere più tempo ricerche successive.

Utilizzando una delle operazioni di ricerca non equivale alla chiamata MoveFirst o MoveNext, tuttavia, fare semplicemente la prima o corrente record successivo senza specificare una condizione.È possibile eseguire un'operazione di ricerca mediante un'operazione di spostamento.

Tenere presente quanto segue quando si utilizzano le operazioni di ricerca:

  • Se Trova restituisce diverso da zero, il record corrente non è definito.In questo caso, è necessario posizionare il puntatore del record corrente su un record valido.

  • Non è possibile utilizzare un'operazione di ricerca con un recordset forward-only di tipo snapshot di scorrimento.

  • È consigliabile utilizzare il formato.. data Stati Uniti (mese giorno anno) quando si individua i campi contenenti i dati, anche se non si utilizza la versione.. Stati Uniti del modulo di gestione di database Microsoft Jet, in caso contrario, fare corrispondere i record non può essere trovato.

  • Quando si utilizzano i database ODBC e grandi dynaset, è possibile individuare quello utilizzando le operazioni di ricerca è lento, specie quando si utilizzano grandi recordset.È possibile migliorare le prestazioni utilizzando query SQL con ORDERpersonalizzatoBY o clausole where, query con parametri, oppure oggetti CDaoQuerydef che recupera i record indicizzati specifici.

Per informazioni correlate, vedere l'argomento "FindFirst, FindLast, FindNext, metodi di FindPrevious" nella Guida di DAO.

Requisiti

Header: afxdao.h

Vedere anche

Riferimenti

Classe di CDaoRecordset

Grafico della gerarchia

CDaoRecordset::Find

CDaoRecordset::FindLast

CDaoRecordset::FindNext

CDaoRecordset::FindPrev