CDaoRecordset::FindFirst

Articolo
03/05/2013

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.

Attenzione
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.