Find-Methode (ADO)
Gilt für: Access 2013, Office 2013
Ein Recordset-Objekt wird nach der Zeile durchsucht, die den angegebenen Kriterien entspricht. Optional können die Richtung der Suche, die Startzeile und der Offset von der Anfangszeile angegeben werden. Wenn die Kriterien erfüllt sind, wird die aktuelle Zeilenposition im gefundenen Datensatz festgelegt. Andernfalls wird die Position auf das Ende (oder den Anfang) des Recordset-Objekts festgelegt.
Syntax
Suchen (Kriterien, SkipRows, SearchDirection, Start)
Parameter
| Parameter | Beschreibung |
|---|---|
| Kriterium | Ein String -Wert mit einer Anweisung, die den Spaltennamen, den Vergleichsoperator und den für die Suche zu verwendenden Wert angibt. |
| SkipRows | Optional. Ein Long-Wert , dessen Standardwert 0 (null) ist und den Zeilenoffset von der aktuellen Zeile oder dem Start-Lesezeichen angibt, um mit der Suche zu beginnen. Standardmäßig beginnt die Suche bei der aktuellen Zeile. |
| SearchDirection | Optional. A SearchDirectionEnum value that specifies whether the search should begin on the current row or the next available row in the direction of the search. An unsuccessful search stops at the end of the Recordset if the value is adSearchForward. An unsuccessful search stops at the start of the Recordset if the value is adSearchBackward. |
| Start | Optional. Eine Variant-Textmarke, die als Startposition für die Suche fungiert. |
Hinweise
Es kann nur ein einzelner Spaltennamen für Criteria angegeben werden. Diese Methode unterstützt keine Suchen über mehrere Spalten.
Der Vergleichsoperator in Criteria kann ">" (größer als), "<" (kleiner als), "=" (gleich), ">=" (größer als oder gleich), "<=" (kleiner oder gleich), "<>" (ungleich) oder "like" (Musterabgleich) sein.
Der Wert in Criteria kann eine Zeichenfolge, Gleitkommazahl oder ein Datum sein. Zeichenfolgenwerte werden in einfache Anführungszeichen oder "#" (Nummernzeichen) gesetzt (z. B. "state = 'WA'" oder "state = #WA#"). Datumswerte sind durch "#"-Markierungen (z. B. "start_date > #22.7.97#") getrennt und können Stunden, Minuten und Sekunden enthalten, um Zeitstempel anzugeben, sollten aber keine Millisekunden enthalten, oder Fehler treten auf.
Ist der Vergleichsoperator "like", kann der Zeichenfolgenwert ein Sternchen (*) enthalten, um nach einem oder mehreren Vorkommen eines beliebigen Zeichens oder einer beliebigen Teilzeichenfolge zu suchen. Bei einer Suche nach "state like 'M*'" werden beispielsweise Maine und Massachusetts gefunden. Sie können auch führende und nachfolgende Sternchen verwenden, um nach einer Teilzeichenfolge innerhalb eines Werts zu suchen. Bei einer Suche nach "state like '*as*'" werden Alaska, Arkansas und Massachusetts gefunden.
Sternchen können, wie oben dargestellt, nur am Ende oder nur am Anfang und am Ende einer Criteria-Zeichenfolge verwendet werden. Sie können das Sternchen nicht als führenden Platzhalter ('*str') oder als eingebetteten Platzhalter ('s*r') verwenden. In diesem Fall tritt ein Fehler auf.
Hinweis
Wird vor dem Aufrufen von Find keine aktuelle Zeilenposition festgelegt, tritt ein Fehler auf. Vor dem Aufrufen von Find sollte eine beliebige Methode aufgerufen werden, die Zeilenpositionen festlegt (z. B. MoveFirst).
Hinweis
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, finden Sie nichts. Sie müssen die MoveFirst-Methode aufrufen, um die aktuelle Position/den aktuellen Cursor am Anfang des Recordsets festzulegen.