Report.Filter-Eigenschaft (Access)

Verwenden Sie die Filter-Eigenschaft , um eine Teilmenge der Datensätze 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

Ausdruck Eine Variable, die ein Report-Objekt darstellt.

HinwBemerkungeneise

Wenn Sie einen Serverfilter in einem Microsoft Access-Projekt (ADP) für Daten auf einem Server angeben möchten, 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 und wendet einen Filter an, um nur Kunden aus den USA anzuzeigen.

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

Hinweis

Das Festlegen der Filter-Eigenschaft hat keine Auswirkungen auf die ADO-Filter-Eigenschaft .

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 Eigenschaften RecordSource, Filter, OrderBy und OrderByOn der Tabelle oder Abfrage, aus der es erstellt wurde.

Um einen gespeicherten Filter auf ein Formular, eine Abfrage oder eine Tabelle anzuwenden, können Sie filter anwenden auf der Symbolleiste auswählen, filter /sortieren im Menü Datensätze anwenden 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-Ereigniseigenschaftseinstellung 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 auf die schaltfläche Filter anwenden klicken, filter /sortieren entfernen im Menü Datensätze auswä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.