Condividi tramite


Metodo Find (ADO)

Cerca in un recordset la riga che soddisfa i criteri specificati. Facoltativamente, è possibile specificare la direzione della ricerca, la riga iniziale e l'offset dalla riga iniziale. Se i criteri sono soddisfatti, la posizione della riga corrente viene impostata sul record trovato; in caso contrario, la posizione è impostata sulla fine (o sull'inizio) dell'oggetto Recordset .

Sintassi

  
Find (Criteria, SkipRows, SearchDirection, Start)  

Parametri

criteri
Valore string che contiene un'istruzione che specifica il nome della colonna, l'operatore di confronto e il valore da utilizzare nella ricerca.

SkipRows
Opzionale. Valore long, il cui valore predefinito è zero, che specifica l'offset di riga dalla riga corrente o segnalibro Start per iniziare la ricerca. Per impostazione predefinita, la ricerca inizierà sulla riga corrente.

SearchDirection
Opzionale. Valore SearchDirectionEnum che specifica se la ricerca deve iniziare sulla riga corrente o sulla riga successiva disponibile nella direzione della ricerca. Una ricerca non riuscita si arresta alla fine del Recordset se il valore è adSearchForward. Una ricerca non riuscita si arresta all'inizio del Recordset se il valore è adSearchBackward.

Start
Opzionale. Segnalibro Variant che funge da posizione iniziale per la ricerca.

Osservazioni

È possibile specificare solo un nome a colonna singola nei criteri di . Questo metodo non supporta ricerche su più colonne.

L'operatore di confronto in Criteria può essere ">" (maggiore di), "<" (minore di), "=" (uguale), ">=" (maggiore o uguale), "<=" (minore o uguale), "<>" (non uguale) o "like" (criteri di ricerca).

Il valore in Criteri può essere una stringa, un numero a virgola mobile o una data. I valori stringa sono delimitati da virgolette singole o "#" (segno di numero), ad esempio "state = 'WA'" o "state = #WA#"). I valori di data sono delimitati da contrassegni "#" (segno di numero), ad esempio "start_date > #7/22/97#"). Questi valori possono contenere ore, minuti e secondi per indicare timestamp, ma non devono contenere millisecondi o errori.

Se l'operatore di confronto è "like", il valore stringa può contenere un asterisco (*) per trovare una o più occorrenze di qualsiasi carattere o sottostringa. Ad esempio, "state like 'M*'" corrisponde a Maine e Massachusetts. È anche possibile usare asterischi iniziali e finali per trovare una sottostringa contenuta nei valori. Ad esempio, "state like '*as*'" corrisponde ad Alaska, Arkansas e Massachusetts.

Gli asterischi possono essere usati solo alla fine di una stringa di criteri o sia all'inizio che alla fine di una stringa di criteri, come illustrato in precedenza. Non è possibile usare l'asterisco come carattere jolly iniziale ('*str') o come carattere jolly incorporato ('s*r'). In questo modo verrà generato un errore.

Nota

Si verificherà un errore se non è impostata una posizione di riga corrente prima di chiamare Trova. Qualsiasi metodo che imposta la posizione della riga, ad esempio MoveFirst, deve essere chiamato prima di chiamare Find.

Nota

Se si chiama il metodo Find su un recordset e la posizione corrente nel recordset si trova all'ultimo record o alla fine del file (EOF), non sarà possibile trovare alcun elemento. È necessario chiamare il metodo MoveFirst per impostare la posizione/cursore corrente all'inizio del recordset.

Si applica a

oggetto Recordset (ADO)

Vedere anche

Esempio di metodo Find (VB)
proprietà Index
Ottimizzare Property-Dynamic (ADO)
metodo Seek