Report. Filter-Eigenschaft (Access)Report.Filter property (Access)

Mit der Filter -Eigenschaft können Sie eine Teilmenge von Datensätzen angeben, die angezeigt werden sollen, wenn ein Filter auf ein Formular, einen Bericht, eine Abfrage oder eine Tabelle angewendet wird.You can use the Filter property to specify a subset of records to be displayed when a filter is applied to a form, report, query, or table. Zeichenfolge mit Lese-/Schreibzugriff.Read/write String.

SyntaxSyntax

Ausdruck. Filterexpression.Filter

Ausdruck Eine Variable, die ein Report -Objekt darstellt.expression A variable that represents a Report object.

BemerkungenRemarks

Wenn Sie in einem Microsoft Access-Projekt (ADP) einen Serverfilter für Daten angeben möchten, die auf einem Server gespeichert sind, verwenden Sie die Serverfilter -Eigenschaft.If you want to specify a server filter within a Microsoft Access project (.adp) for data located on a server, use the ServerFilter property.

Die Filter-Eigenschaft ist ein Zeichenfolgenausdruck und besteht aus einer WHERE-Klausel ohne das Schlüsselwort WHERE.The Filter property is a string expression consisting of a WHERE clause without the WHERE keyword. Der folgende Visual Basic-Code definiert und wendet beispielsweise einen Filter an, um nur Kunden aus den USA anzuzeigen.For example, the following Visual Basic code defines and applies a filter to show only customers from the USA.

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

Hinweis

Das Festlegen der Filter -Eigenschaft hat keine Auswirkungen auf die ADO- Filter Eigenschaft.Setting the Filter property has no effect on the ADO Filter property.

Mithilfe der Filter-Eigenschaft können Sie einen Filter speichern und zu einem späteren Zeitpunkt anwenden.You can use the Filter property to save a filter and apply it at a later time. Filter werden mit den Objekten gespeichert, in denen sie erstellt wurden.Filters are saved with the objects in which they are created. Sie werden zwar automatisch geladen, wenn das Objekt geöffnet wird, aber werden nicht automatisch angewendet.They are automatically loaded when the object is opened, but they aren't automatically applied.

Wenn ein neues Objekt erstellt wird, erbt es die Eigenschaftendaten Satz Herkunft, Filter, OrderByund OrderByOn der Tabelle oder Abfrage, aus der es erstellt wurde.When a new object is created, it inherits the RecordSource, Filter, OrderBy, and OrderByOn properties of the table or query that it was created from.

Wenn Sie einen gespeicherten Filter auf ein Formular, eine Abfrage oder eine Tabelle anwenden möchten, können Sie auf der Symbolleiste auf Filter anwenden klicken, im Menü Datensätze auf Filter/Sortierung anwenden klicken oder mit einem Makro oder Visual Basic die FilterOn -Eigenschaft auf truefestlegen.To apply a saved filter to a form, query, or table, you can choose Apply Filter on the toolbar, choose Apply Filter/Sort on the Records menu, or use a macro or Visual Basic to set the FilterOn property to True. Auf Berichte können Sie einen Filter anwenden, indem Sie im Eigenschaftenfenster des Berichts die FilterOn -Eigenschaft auf „Ja" festlegen.For reports, you can apply a filter by setting the FilterOn property to Yes in the report's property sheet.

Die Schaltfläche Filter anwenden zeigt den Status der Eigenschaften Filter und FilterOn an.The Apply Filter button indicates the state of the Filter and FilterOn properties. Die Schaltfläche ist deaktiviert, solange es keinen Filter gibt, der angewendet werden kann.The button remains disabled until there is a filter to apply. Ist bereits ein vorhandener Filter angewendet, wird die Schaltfläche Filter/Sortierung anwenden im gedrückten Zustand angezeigt.If an existing filter is currently applied, the Apply Filter button appears pressed in.

Wenn ein Filter beim Öffnen eines Formulars automatisch angewendet werden soll, geben Sie **** in der OnOpen-Ereignis Eigenschaftseinstellung des Formulars entweder ein Makro an, das die ApplyFilter-Aktion verwendet, oder eine Ereignisprozedur, die die ApplyFilter -Methode des DoCmd -Objekts verwendet.To apply a filter automatically when a form is opened, specify in the OnOpen event property setting of the form either a macro that uses the ApplyFilter action or an event procedure that uses the ApplyFilter method of the DoCmd object.

Sie können einen Filter entfernen, indem Sie die Schaltfläche Filter anwenden drücken, im Menü Datensätze auf Filter/Sortierung entfernen klicken oder Visual Basic verwenden, um die FilterOn -Eigenschaft auf falsefestzulegen.You can remove a filter by choosing the pressed-in Apply Filter button, choosing Remove Filter/Sort on the Records menu, or using Visual Basic to set the FilterOn property to False.

Wenn die Filter-Eigenschaft in der Formularentwurfsansicht eingestellt wird, versucht Microsoft Access nicht, den SQL-Ausdruck zu bestätigen.When the Filter property is set in form Design view, Microsoft Access does not attempt to validate the SQL expression. Ist der SQL-Ausdruck ungültig, so tritt beim Anwenden des Filters ein Fehler auf.If the SQL expression is invalid, an error occurs when the filter is applied.

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.