Form.ServerFilter-Eigenschaft (Access)

Verwenden Sie die ServerFilter-Eigenschaft , um eine Teilmenge der Datensätze anzugeben, die angezeigt werden sollen, wenn ein Serverfilter auf ein Formular in einem Microsoft Access-Projekt (ADP) oder einer Datenbank angewendet wird. Zeichenfolge mit Lese-/Schreibzugriff.

Syntax

Ausdruck. Serverfilter

expression Eine Variable, die ein Form-Objekt darstellt.

HinwBemerkungeneise

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

Me.ServerFilter = "Country = 'USA'" 
Me.Refresh

Um die ServerFilter-Eigenschaft festzulegen, müssen Sie zunächst einen der folgende Schritte durchführen:

• Legen Sie den Wert der Eigenschaft im Eigenschaftenfenster des Formulars fest.

• Legen Sie die -Eigenschaft in Visual Basic fest, indem Sie den folgenden Code eingeben:

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

Verwenden Sie die ServerFilter-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.

Um einen gespeicherten Filter auf ein Formular anzuwenden, können Sie auf der Symbolleiste Serverfilter anwenden auswählen, im Menü Datensätze die Option Filter/Sortieren anwenden auswählen oder ein Makro oder Visual Basic verwenden, um die ServerFilterByForm-Eigenschaft auf True festzulegen.

Die Schaltfläche Serverfilter anwenden zeigt den Status der Eigenschaften ServerFilter und ServerFilterByForm an. Die Schaltfläche ist solange deaktiviert, bis ein Filter vorhanden ist, der angewendet werden kann. Wenn momentan ein vorhandener Filter angewendet wird, wird die Schaltfläche Serverfilter anwenden in gedrücktem Zustand dargestellt.

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. In beiden Fällen wird das Formular im Fenster Server filtern nach Formular geöffnet.

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 nach Formular löschen und dann Serverfilter anwenden auswählen.

Wenn die ServerFilterServerFilter-Eigenschaft in der Formular-Entwurfsansicht festgelegt wird, versucht Microsoft Access nicht, den SQL-Ausdruck zu überprüfen. 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.