Sie können die AnwendenFilter-Aktion verwenden, um eine Filter, eine Abfrage oder eine SQL WHERE-Klausel auf eine Tabelle, Formular oder Bericht anzuwenden, um die Datensätze in der Tabelle oder die Datensätze aus der zugrunde liegenden Tabelle oder Abfrage des Formulars oder Berichts einzuschränken oder zu sortieren. Für Berichte können Sie diese Aktion nur in einer Makro verwenden, die von der OnOpen-Ereigniseigenschaft des Berichts angegeben wird.
Hinweis: Zum Anwenden einer SQL WHERE-Klausel können Sie diese Aktion nur verwenden, wenn Sie einen Serverfilter anwenden. Ein Serverfilter kann nicht auf die Datensatzquelle einer gespeicherten Prozedur angewendet werden.
Hinweis: Die Makroaktion "AnwendenFilter" steht in Access-Web-Apps nicht zur Verfügung.
Einstellung
Die Aktion AnwendenFilter weist die folgenden Argumente auf:
|
Aktionsargument |
Beschreibung |
|
Filtername |
Der Name eines Filters oder einer Abfrage, der die Datensätze der Tabelle, des Formulars oder des Berichts einschränkt oder sortiert. Sie können den Namen einer vorhandenen Abfrage oder eines Filters, der als Abfrage gespeichert wurde, in das Feld Filtername im Abschnitt Aktionsargumente des Bereichs Makro-Generator eingeben. Hinweis: Wenn Sie mit dieser Aktion einen Serverfilter anwenden möchten, muss das Argument Filtername leer sein. |
|
Bedingung |
Eine gültige SQL WHERE-Klausel (ohne das Wort WHERE) oder ein Ausdruck, der die Datensätze der Tabelle, des Formulars oder des Berichts einschränkt. Hinweis: In einem Where Condition-Argumentausdruck enthält die linke Seite des Ausdrucks in der Regel einen Feldnamen aus der zugrunde liegenden Tabelle oder Abfrage für das Formular oder den Bericht. Die rechte Seite des Ausdrucks enthält in der Regel die Kriterien, die Sie auf dieses Feld anwenden möchten, um die Datensätze einzuschränken oder zu sortieren. Die Kriterien können beispielsweise der Name eines Steuerelements in einem anderen Formular sein, das den Wert enthält, mit dem die Datensätze im ersten Formular übereinstimmen sollen. Der Name des Steuerelements sollte voll qualifiziert sein, z. B.: Formulare!Formularname!Steuerelementname Feldnamen sollten von Anführungszeichen umgeben sein und Zeichenfolgenliterale von Hochkommas. Das Argument Bedingung darf maximal 255 Zeichen enthalten. Verwenden Sie die ApplyFilter -Methode des DoCmd-Objekts in einem VBA-Modul (Visual Basic for Applications), wenn Sie eine längere SQL WHERE-Klausel eingeben müssen. Sie können SQL WHERE-Klauselanweisungen in VBA mit bis zu 32.768 Zeichen eingeben. |
Hinweis: Sie können das Argument Filtername verwenden, wenn Sie bereits einen Filter definiert haben, der die entsprechenden Daten bereitstellt. Sie können das Argument Bedingung verwenden, um die Einschränkungskriterien direkt einzugeben. Wenn Sie beide Argumente verwenden, wendet Access die WHERE-Klausel auf die Ergebnisse des Filtervorgangs an. Sie müssen mindestens eines der Argumente verwenden.
Hinweise
Sie können einen Filter oder eine Abfrage auf ein Formular in der Formularansicht oder in der Datenblattansicht anwenden.
Der angewendete Filter und die WHERE-Bedingung werden zur Einstellung der Filter- oder Serverfilter-Eigenschaft des Formulars oder des Berichts.
Für Tabellen und Formulare ist diese Aktion mit dem Klicken auf Filter/Sortierung anwenden oder Serverfilter anwenden im Menü Datensätze vergleichbar. Der Menübefehl wendet den zuletzt erstellten Filter auf die Tabelle oder das Formular an, wohingegen die AnwendenFilter-Aktion einen angegebenen Filter oder eine angegebene Abfrage anwendet.
Wenn Sie in einer Access-Datenbank im Menü Datensätze auf Filter zeigen und nach dem Ausführen der AnwendenFilter-Aktion auf Spezialfilter/-sortierung klicken, werden im Fenster Fenster "Spezialfilter/-sortierung" die Filterkriterien angezeigt, die Sie mit dieser Aktion ausgewählt haben.
Um einen Filter zu entfernen und alle Datensätze für eine Tabelle oder ein Formular in einer Access-Datenbank anzuzeigen, können Sie die Aktion AnzeigenAlleDatensätze oder den Befehl Filter/Sortieren entfernen im Menü Datensätze verwenden. Um einen Filter in einem Access-Projekt (ADP) zu entfernen, können Sie zum Formularbasierter Serverfilter Fenster zurückkehren und alle Filterkriterien entfernen. Klicken Sie dann auf der Symbolleiste im Menü Datensätze auf Serverfilter anwenden, oder legen Sie die ServerFilterByForm-Eigenschaft auf False (0) fest.
Wenn Sie eine Tabelle oder ein Formular speichern, speichert Access alle filter, die derzeit in diesem Objekt definiert sind, wendet den Filter jedoch nicht automatisch an, wenn das Objekt das nächste Mal geöffnet wird (obwohl automatisch jede Sortierung angewendet wird, die Sie auf das Objekt angewendet haben, bevor es gespeichert wurde). Wenn Sie beim ersten Öffnen eines Formulars automatisch einen Filter anwenden möchten, geben Sie ein Makro an, das die ApplyFilter-Aktion oder eine Ereignisprozedur enthält, die die ApplyFilter-Methode des DoCmd-Objekts als OnOpen-Ereigniseigenschaftseinstellung des Formulars enthält. Sie können einen Filter auch mithilfe der OpenForm- oder OpenReport-Aktion oder der entsprechenden Methoden anwenden. Um einen Filter automatisch anzuwenden, wenn eine Tabelle zum ersten Mal geöffnet wird, können Sie die Tabelle mithilfe eines Makros öffnen, das die OpenTable-Aktion enthält, gefolgt von der Aktion AnwendenFilter .
Beispiel
Anwenden eines Filters mithilfe eines Makros
Das folgende Makro enthält eine Reihe von Aktionen, von denen jede die Datensätze für ein Kundentelefonlistenformular filtert. Es zeigt die Verwendung der Aktionen ApplyFilter, ShowAllRecords und GoToControl . Es zeigt auch die Verwendung von Bedingungen, um zu bestimmen, welche Umschaltfläche in einer Optionsgruppe auf dem Formular ausgewählt wurde. Jede Aktionszeile ist einer Umschaltfläche zugeordnet, die die Datensätze auswählt, die mit A, B, C usw. oder allen Datensätzen beginnen. Dieses Makro sollte an das AfterUpdate-Ereignis der Optionsgruppe CompanyNameFilter angefügt werden.
|
Bedingung |
Aktion |
Argumente: Einstellung |
Kommentar |
|
[CompanyNameFilters]=1 |
AnwendenFilter |
Bedingung: [Firmenname] wie "[AÀÁÂÃÄ]*" |
Filter auf Firmennamen, die mit A, À, Á, Â, Ã oder Ä beginnen. |
|
[CompanyNameFilters]=2 |
AnwendenFilter |
Bedingung: [Firmenname] wie "B" |
Filter auf Firmennamen, die mit B beginnen. |
|
[CompanyNameFilters]=3 |
AnwendenFilter |
Bedingung: [Firmenname] wie "[CÇ]*" |
Filter auf Firmennamen, die mit C oder Ç beginnen. |
|
... Aktionszeilen für D bis Y besitzen dasselbe Format wie für A bis C... |
|||
|
[CompanyNameFilters]=26 |
AnwendenFilter |
Bedingung: [Firmenname] wie "[ZÆØÅ]*" |
Filter auf Firmennamen, die mit Z, Æ, Ø oder Å beginnen. |
|
[CompanyNameFilters]=27 |
AnzeigenAlleDatensätze |
Zeigt alle Datensätze an. |
|
|
[RecordsetClone].[RecordCount]>0 |
GeheZuSteuerelement |
Name des Steuerelements: Firmenname |
Wenn für den ausgewählten Buchstaben Datensätze zurückgegeben werden, setzen Sie den Fokus auf das Steuerelement "CompanyName". |
