CDaoRecordset::FindFirst

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

Valore restituito

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

Parametri

lpszFilter

Espressione stringa (come la clausola WHERE in un'istruzione SQL senza la parola dove) utilizzata per individuare il record.

Osservazioni

Chiamare questa funzione membro per trovare il primo record che corrisponde a una condizione specificata. La funzione membro FindFirst inizia la ricerca dall'inizio dell'oggetto recordset e ricerche per la fine del recordset.

Se si desidera includere tutti i record nella vostra ricerca (non solo quelli che soddisfano una condizione specifica) utilizzano una delle operazioni di spostamento per spostare da record per record. Per individuare un record in un recordset di tipo tabella, chiamare la funzione membro Seek.

Se un record che corrispondono ai criteri non si trova, il puntatore del record corrente è indeterminato e FindFirst restituisce zero. Se il recordset contiene più di un record che soddisfa i criteri, che FindFirst individua la prima occorrenza, TrovaSuccessivo individua l'occorrenza successiva e così via.

Cautela   Se si modifica il record corrente, assicurarsi di salvare le modifiche chiamando la funzione membro Update prima di spostare su un altro record. Se si sposta su un altro record senza aggiornare, le modifiche vengono perse senza preavviso.

Le funzioni membro di trovare ricerca dalla posizione e nella direzione specificata nella tabella seguente:

Trovare le operazioni Begin Direzione di ricerca
FindFirst Inizio del recordset Fine del recordset
FindLast Fine del recordset Inizio del recordset
TrovaSuccessivo Record corrente Fine del recordset
FindPrevious Record corrente Inizio del recordset

Importa&ntenbsp;  Quando si chiama FindLast, il motore di database Microsoft Jet completamente popola il recordset prima di iniziare la ricerca, se questo non è già stato fatto. La prima ricerca può richiedere più tempo rispetto a successive ricerche.

Utilizzando una delle operazioni di ricerca non è la stessa chiamata MoveFirst o MoveNext, tuttavia, che fa semplicemente il primo o successivo record corrente senza specificare una condizione. È possibile seguire un'operazione di ricerca con un'operazione di spostamento.

Tenere presente le seguenti quando si utilizza le operazioni di ricerca:

Per ulteriori informazioni sulla ricerca di record, vedere l'articolo Recordset DAO: navigazione Recordset nel manuale del programmatore di Visual C++. Per informazioni correlate, vedere l'argomento "FindFirst, FindLast, TrovaSuccessivo, FindPrevious metodi" nella guida di DAO.

Pa&noramica CDaoRecordset |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CDaoRecordset::Find, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev

Index