DoCmd.SetFilter-Methode (Access)
Mit der SetFilter-Methode können Sie auf die Datensätze im aktiven Datenblatt, im aktiven Formular, im aktiven Bericht oder in der aktuellen Tabelle einen Filter anwenden.
Syntax
Ausdruck. SetFilter (FilterName, WhereCondition, ControlName)
expression Eine Variable, die ein DoCmd-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| FilterName | Optional | Variant | Der Name einer Abfrage oder eines Filters, der als Abfrage gespeichert wurde (sofern angegeben). Dieses Argument oder das WhereCondition-Argument ist erforderlich. |
| WhereCondition | Optional | Variant | Eine SQL WHERE-Klausel, die die Datensätze im Datenblatt, im Formular, im Bericht oder in der Tabelle einschränkt (sofern angegeben). |
| ControlName | Optional | Variant | Der Name des Steuerelements, das dem zu filternden Unterformular oder Unterbericht entspricht (sofern angegeben). Ohne Angabe wird das aktuelle Objekt gefiltert. |
Hinweise
Wenn Sie diese Methode ausführen, wird der Filter auf die Tabelle, das Formular, den Bericht oder das Datenblatt (z. B. ein Abfrageergebnis) angewendet, die/das/der aktiv ist und den Fokus hat.
Die Filter-Eigenschaft des aktiven Objekts wird verwendet, um das Argument WhereCondition zu speichern und zu einem späteren Zeitpunkt anzuwenden. Filter werden mit den Objekten gespeichert, in denen sie erstellt wurden. Sie werden zwar automatisch geladen, wenn das Objekt geöffnet wird, aber werden nicht automatisch angewendet.
Um automatisch einen Filter anzuwenden, wenn das Objekt geöffnet wird, legen Sie die FilterOnLoad-Eigenschaft auf True fest.
Beispiel
Im folgenden Codebeispiel wird das aktive Objekt so gefiltert, dass nur Datensätze angezeigt werden, die mit "NWTB" beginnen.
DoCmd.SetFilter WhereCondition:="[Product Code] Like ""NWTB*"""
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.