DoCmd.SetFilter-Methode (Access)

  • Artikel

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.

HinwBemerkungeneise

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.