Form.Filter-Eigenschaft (Access)

Verwenden Sie die Filter-Eigenschaft, um eine Teilmenge von Datensätzen anzugeben, die angezeigt werden sollen, wenn ein Filter auf ein Formular, einen Bericht, eine Abfrage oder eine Tabelle angewendet wird. Zeichenfolge mit Lese-/Schreibzugriff.

Syntax

Ausdruck.Filter

expression Eine Variable, die ein Form-Objekt darstellt.

Hinweise

Wenn Sie einen Serverfilter innerhalb eines Microsoft Access-Projekts (.adp) für Daten angeben möchten, die sich auf einem Server befinden, verwenden Sie die ServerFilter-Eigenschaft .

Die Filter-Eigenschaft ist ein Zeichenfolgenausdruck und besteht aus einer WHERE-Klausel ohne das Schlüsselwort WHERE. Der folgende Visual Basic-Code definiert z. B. einen Filter und wendet ihn an, um nur Kunden aus den USA anzuzeigen.

Me.Filter = "Country = 'USA'" 
Me.FilterOn = True

Verwenden Sie die Filter-Eigenschaft, um einen Filter 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.

Wenn ein neues Objekt erstellt wird, erbt es die RecordSource-, Filter-, OrderBy- und OrderByOn-Eigenschaften der Tabelle oder Abfrage, aus der es erstellt wurde.

Wenn Sie einen gespeicherten Filter auf ein Formular, eine Abfrage oder eine Tabelle anwenden möchten, können Sie in der Symbolleiste die Option Filter anwenden / Sortieren im Menü Datensätze auswählen oder ein Makro oder Visual Basic verwenden, um die FilterOn-Eigenschaft auf True festzulegen. Auf Berichte können Sie einen Filter anwenden, indem Sie im Eigenschaftenfenster des Berichts die FilterOn -Eigenschaft auf „Ja" festlegen.

Die Schaltfläche Filter anwenden zeigt den Status der Eigenschaften Filter und FilterOn an. Die Schaltfläche ist deaktiviert, solange es keinen Filter gibt, der angewendet werden kann. Ist bereits ein vorhandener Filter angewendet, wird die Schaltfläche Filter/Sortierung anwenden im gedrückten Zustand angezeigt.

Um beim Öffnen eines Formulars automatisch einen Filter anzuwenden, geben Sie in der OnOpen-Ereigniseigenschafteinstellung des Formulars entweder ein Makro an, das die ApplyFilter-Aktion verwendet, oder eine Ereignisprozedur, die die ApplyFilter-Methode des DoCmd-Objekts verwendet.

Sie können einen Filter entfernen, indem Sie die aktivierte Schaltfläche Filter anwenden auswählen, im Menü DatensätzeFilter/Sortieren entfernen wählen oder Visual Basic verwenden, um die FilterOn-Eigenschaft auf False festzulegen.

Wenn die Filter-Eigenschaft in der Formularentwurfsansicht eingestellt wird, versucht Microsoft Access nicht, den SQL-Ausdruck zu bestätigen. Ist der SQL-Ausdruck ungültig, so tritt beim Anwenden des Filters ein Fehler auf.

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.