Find-Methode (ADO)
Durchsucht ein Recordset- für die Zeile, die den angegebenen Kriterien entspricht. Optional kann die Richtung der Suche, der Anfangszeile und des Offsets aus der Anfangszeile angegeben werden. Wenn die Kriterien erfüllt sind, wird die aktuelle Zeilenposition für den gefundenen Datensatz festgelegt; andernfalls wird die Position auf das Ende (oder den Anfang) des Recordsetfestgelegt.
Syntax
Find (Criteria, SkipRows, SearchDirection, Start)
Parameter
Kriterien
Ein String- Wert, der eine Anweisung enthält, die den Spaltennamen, Vergleichsoperator und Wert für die Suche angibt.
SkipRows-
Wahlfrei. Ein Long-Wert, dessen Standardwert null ist, der den Zeilenoffset aus der aktuellen Zeile angibt, oder Textmarke starten, um die Suche zu starten. Standardmäßig beginnt die Suche in der aktuellen Zeile.
SearchDirection-
Wahlfrei. Ein SearchDirectionEnum Wert, der angibt, ob die Suche in der aktuellen Zeile oder in der nächsten verfügbaren Zeile in Richtung der Suche beginnen soll. Eine nicht erfolgreiche Suche wird am Ende des Recordset- beendet, wenn der Wert adSearchForward-ist. Eine nicht erfolgreiche Suche wird am Anfang des Recordset- beendet, wenn der Wert adSearchBackwardist.
starten
Wahlfrei. Eine Variant Textmarke, die als Startposition für die Suche fungiert.
Bemerkungen
Nur ein Spaltenname kann in Kriterienangegeben werden. Diese Methode unterstützt keine mehrspaltigen Suchvorgänge.
Der Vergleichsoperator in Criteria kann ">" (größer als), "<" (kleiner als), "=" (gleich), ">=" (größer oder gleich), "<=" (kleiner oder gleich), "<>" (nicht gleich) oder "like" (Musterabgleich) sein.
Der Wert in Kriterien kann eine Zeichenfolge, Gleitkommazahl oder ein Datum sein. Zeichenfolgenwerte werden durch einfache Anführungszeichen oder "#" (Nummernzeichen) getrennt (z. B. "state = 'WA'" oder "state = #WA#"). Datumswerte werden durch "#" (Nummernzeichen) getrennt (z. B. "start_date > #7/22/97#"). Diese Werte können Stunden, Minuten und Sekunden enthalten, um Zeitstempel anzugeben, sollten jedoch keine Millisekunden enthalten oder Fehler auftreten.
Wenn der Vergleichsoperator "like" ist, kann der Zeichenfolgenwert ein Sternchen (*) enthalten, um ein oder mehrere Vorkommen eines beliebigen Zeichens oder einer Teilzeichenfolge zu finden. "State like 'M*'" entspricht beispielsweise Maine und Massachusetts. Sie können auch führende und nachfolgende Sternchen verwenden, um eine Teilzeichenfolge zu finden, die in den Werten enthalten ist. Beispielsweise entspricht "State like '*as*'" Alaska, Arkansas und Massachusetts.
Sternchen können nur am Ende einer Kriterienzeichenfolge oder sowohl am Anfang als auch am Ende einer Kriterienzeichenfolge verwendet werden, wie oben dargestellt. Sie können das Sternchen nicht als führendes Wildcardzeichen ('*str') oder als eingebetteten Wildcard ('s*r') verwenden. Dies führt zu einem Fehler.
Anmerkung
Wenn vor dem Aufrufen von Findeine aktuelle Zeilenposition nicht festgelegt wird, tritt ein Fehler auf. Jede Methode, die die Zeilenposition festlegt, z. B. MoveFirst-, sollte vor dem Aufrufen Findaufgerufen werden.
Anmerkung
Wenn Sie die Find-Methode für ein Recordset aufrufen und sich die aktuelle Position im Recordset am letzten Datensatz oder Ende der Datei (EOF) befindet, werden Sie nichts finden. Sie müssen die MoveFirst-Methode aufrufen, um die aktuelle Position/den Cursor auf den Anfang des Recordsets festzulegen.
Gilt für
Siehe auch
Find-Methode (Beispiel) (VB)
Index-Eigenschaft
Optimieren Property-Dynamic (ADO)
Seek-Methode