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

Mit der Serverfilter -Eigenschaft können Sie eine Teilmenge von Datensätzen angeben, die angezeigt werden sollen, wenn ein Serverfilter auf einen Bericht in einem Microsoft Access-Projekt (ADP) oder einer Datenbank angewendet wird.You can use the ServerFilter property to specify a subset of records to be displayed when a server filter is applied to a report within a Microsoft Access project (.adp) or database. Zeichenfolge mit Lese-/Schreibzugriff.Read/write String.

SyntaxSyntax

Ausdruck. Serverfilterexpression.ServerFilter

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

BemerkungenRemarks

Die ServerFilterServerFilter-Eigenschaft ist ein Zeichenfolgenausdruck, der aus einer WHERE-Klausel ohne das WHERE-Schlüsselwort besteht.The ServerFilter 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.ServerFilter = "Country = 'USA'" 
Me.Refresh

Um die ServerFilter-Eigenschaft festzulegen, müssen Sie zunächst einen der folgende Schritte durchführen:To set the ServerFilter property, you must first either:

  • Legen Sie den Wert der Eigenschaft im Eigenschaftenfenster des Formulars fest.Set the property value in the form's property sheet.

  • Legen Sie die-Eigenschaft in Visual Basic fest, indem Sie den folgenden Code eingeben:Set the property in Visual Basic by typing the following code:

      Forms(0).ServerFilter = "fieldname = value "
    

Hinweis

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

Mit der ServerFilterServerFilter-Eigenschaft können Sie auch einen Filter speichern, um ihn zu einem späteren Zeitpunkt anzuwenden.You can use the ServerFilter 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 Sie einen gespeicherten Filter auf ein Formular anwenden möchten, können Sie auf der Symbolleiste auf Server Filter anwenden klicken, im Menü Datensätze auf Filter/Sortierung anwenden klicken oder mit einem Makro oder Visual Basic die ServerFilterByForm -Eigenschaft auf truefestlegen.To apply a saved filter to a form, you can choose Apply Server Filter on the toolbar, choose Apply Filter/Sort on the Records menu, or use a macro or Visual Basic to set the ServerFilterByForm property to True.

Die Schaltfläche Serverfilter anwenden zeigt den Status der Eigenschaften ServerFilter und ServerFilterByForm an.The Apply Server Filter button indicates the state of the ServerFilter and ServerFilterByForm properties. Die Schaltfläche ist solange deaktiviert, bis ein Filter vorhanden ist, der angewendet werden kann.The button remains disabled until there is a filter to apply. Wenn momentan ein vorhandener Filter angewendet wird, wird die Schaltfläche Serverfilter anwenden in gedrücktem Zustand dargestellt.If an existing filter is currently applied, the Apply Server 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. In beiden Fällen wird das Formular im Fenster Server Filter für Formular geöffnet.In either case, the form opens in the Server Filter By Form window.

Sie können einen Serverfilter nur entfernen, indem Sie Visual Basic verwenden, um die ServerFilterByForm -Eigenschaft auf false festzulegen oder alle Filterkriterien im Fenster Serverfilter für Formular zu löschen, und wählen Sie dann Serverfilter anwendenaus.You can only remove a server filter by using Visual Basic to set the ServerFilterByForm property to False or clear all filter criteria in the Server Filter By Form window, and then choose Apply Server Filter.

Wenn die Serverfilter -Eigenschaft in der Formularentwurfsansicht festgelegt ist, versucht Access nicht, den SQL-Ausdruck zu überprüfen.When the ServerFilter property is set in form Design view, 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.