Find-Methode (ADO)

  • Artikel

Durchsucht ein Recordset nach der Zeile, die den angegebenen Kriterien entspricht. Optional können die Richtung der Suche, die Startzeile und der Offset von der Startzeile angegeben werden. Wenn die Kriterien erfüllt sind, wird die aktuelle Zeilenposition des gefundenen Datensatzes festgelegt; andernfalls wird die Position auf das Ende (oder den Anfang) des Recordsets festgelegt.

Syntax

  
Find (Criteria, SkipRows, SearchDirection, Start)

Parameter

Kriterien
Ein String-Wert mit einer Anweisung, die den Spaltennamen, den Vergleichsoperator und den Wert angibt, der in der Suche verwendet werden soll.

SkipRows
Optional. Ein Long-Wert, dessen Standardwert null ist und der den Zeilenoffset von der aktuellen Zeile oder der Start-Textmarke angibt, um die Suche zu beginnen. Standardmäßig beginnt die Suche bei der aktuellen Zeile.

SearchDirection
Optional. Ein SearchDirectionEnum-Wert, der angibt, ob die Suche in der aktuellen Zeile oder der nächsten verfügbaren Zeile in Suchrichtung beginnen soll. Wenn der Wert adSearchForward lautet, wird eine nicht erfolgreiche Suche am Ende des Recordsets beendet. Lautet der Wert adSearchBackward, wird eine nicht erfolgreiche Suche am Anfang des Recordsets beendet.

Starten
Optional. Eine Variant-Textmarke, die als Ausgangsposition für die Suche funktioniert.

Bemerkungen

Für das Kriterium kann nur ein einzelner Spaltenname angegeben werden. Diese Methode unterstützt keine Mehrspaltensuche.

Der Vergleichsoperator für das Kriterium kann > (größer als), < (kleiner als), = (gleich), >= (größer oder gleich), <= (kleiner oder gleich), <> (ungleich) oder „like“ (Musterabgleich) sein.

Der Wert für das Kriterium kann eine Zeichenfolge, Gleitkommazahl oder ein Datum sein. Zeichenfolgenwerte werden durch einzelne 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. Bei Angabe von Millisekunden treten jedoch Fehler auf.

Wenn der Vergleichsoperator „like“ ist, kann der Zeichenfolgenwert ein Sternchen (*) enthalten, um nach einem oder mehreren Vorkommen eines Zeichens oder einer Teilzeichenfolge zu suchen. Für die Suche „State like 'M*'“ werden z. B. Maine und Massachusetts gefunden. Sie können Sternchen auch voran- oder nachstellen, um nach einer Teilzeichenfolge zu suchen, die in den Werten enthalten ist. Für die Suche „State like '*as*'“ werden beispielsweise Alaska, Arkansas und Massachusetts gefunden.

Sternchen können, wie oben gezeigt, nur am Ende einer Kriterienzeichenfolge bzw. sowohl am Anfang als auch am Ende einer Kriterienzeichenfolge verwendet werden. Sie können das Sternchen nicht als vorangestellten Platzhalter („*str“) oder eingebetteten Platzhalter („s*r“) verwenden. In diesem Fall tritt ein Fehler auf.

Hinweis

Wenn vor dem Aufruf von Find keine aktuelle Zeilenposition festgelegt ist, tritt ein Fehler auf. Rufen Sie daher eine Methode zum Festlegen der Zeilenposition (z. B. MoveFirst) auf, bevor Sie Find aufrufen.

Hinweis

Wenn Sie die Find-Methode für ein Recordset aufrufen und sich die aktuelle Position im Recordset am letzten Datensatz oder am Ende der Datei (EOF) befindet, erfolgt die Suche ohne Ergebnis. Rufen Sie die MoveFirst-Methode auf, um die aktuelle Position/den Cursor auf den Anfang des Recordsets festzulegen.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Find-Methode – Beispiel (VB)
Index-Eigenschaft
Optimize – dynamische Eigenschaft (ADO)
Seek-Methode