DoCmd.FindRecord-Methode (Access)

Die FindRecord-Methode führt die SuchenDatensatz-Aktion in Visual Basic aus.

Syntax

Ausdruck. FindRecord (FindWhat, Match, MatchCase, Search, SearchAsFormatted, OnlyCurrentField, FindFirst)

expression Eine Variable, die ein DoCmd-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Findwhat Erforderlich Variant Ein Ausdruck, der zu einem Text, einer Zahl oder einem Datum ausgewertet wird. Der Ausdruck enthält die zu suchenden Daten.
Match Optional AcFindMatch Eine AcFindMatch-Konstante , die angibt, wo nach der Übereinstimmung gesucht werden soll. Der Standardwert lautet acEntire.
MatchCase Optional Variant Verwenden Sie True für eine Suche, bei der nach Groß- und Kleinschreibung unterschieden wird, und False für eine Suche, bei der nicht nach Groß- und Kleinschreibung unterschieden wird. Wenn Sie dieses Argument leer lassen, wird der Standard (False) angenommen.
Search Optional AcSearchDirection Eine AcSearchDirection-Konstante , die die Suchrichtung angibt. Der Standardwert lautet acSearchAll.
SearchAsFormatted Optional Variant Verwenden Sie True, um Daten so zu suchen, wie sie formatiert sind, und False, um Daten so zu suchen, wie sie in der Datenbank gespeichert sind. Wenn Sie dieses Argument leer lassen, wird der Standard (False) angenommen.
OnlyCurrentField Optional AcFindField Eine AcFindField-Konstante , die angibt, ob alle Felder oder nur das aktuelle Feld durchsucht werden sollen. Der Standardwert lautet acCurrent.
FindFirst Optional Variant Verwenden Sie True, um die Suche im ersten Datensatz zu beginnen. Verwenden Sie False, um die Suche im Datensatz zu beginnen, der auf den aktuellen Datensatz folgt. Wenn Sie für dieses Argument keinen Wert angeben, wird der Standardwert (True) verwendet.

HinwBemerkungeneise

Wenn eine Prozedur die FindRecord-Methode aufruft, sucht Access nach den angegebenen Daten in den Datensätzen (die Reihenfolge der Suche wird durch die Einstellung des Arguments Search bestimmt). When Access finds the specified data, the data is selected in the record.

Mit der FindRecord-Methode wird kein Wert zurückgegeben, der auf ihre erfolgreiche oder fehlerhafte Ausführung hinweist. Um zu bestimmen, ob ein Wert in einem Recordset vorhanden ist, verwenden Sie die FindFirst-, FindNext-, FindPrevious- oder FindLast-Methode des Recordset-Objekts . Diese Methoden legen den Wert der NoMatch-Eigenschaft auf True fest, wenn der angegebene Wert nicht gefunden wird.

Beispiel

Dieses Beispiel sucht im aktuellen Feld der Datensätze nach dem ersten Vorkommen des Namens "Schmitt". Die Zeichenfolgen "schmitt" und "Schmittchen" werden nicht gefunden.

DoCmd.FindRecord "Smith",, True,, True

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.