Eigenschaft Filter

Komponenten
Syntax:
Eigenschaft Filter: String


Beschreibung:
Die Eigenschaft Filter legt den Text des aktuellen Filters einer Datenmenge fest.

Geben Sie mit Filter einen Datenmengenfilter an. Wird eine Datenmenge gefiltert, sind nur die Datensätze für eine Anwendung verfügbar, die den angegebenen Bedingungen entsprechen. Die Eigenschaft Filter enthält die Filterbedingung. So werden beispielsweise durch den folgenden Filter nur die Datensätze angezeigt, bei denen im Feld State der Wert "CA" oder "MA" enthalten ist:

State = 'CA' or State = 'MA'

In einer gefilterten Datenmenge werden leere Datensätze nur angezeigt, wenn diese explizit in den Filter einbezogen werden. Ein Beispiel:

State <> 'CA' or State = NULL

Feldnamen mit Leerzeichen müssen in eckige Klammern gesetzt werden. Ein Beispiel:

Home State = 'CA' or Home State = 'MA'

Filterausdrücke für externe SQL-Tabellen und Client-Datenmengen unterstützen Feldvergleiche. Ein Beispiel:

Field1 > Field2

Feldvergleiche werden aber nicht für lokale Tabellen (Paradox, dBASE, Access, FoxPro) unterstützt.

Eine Liste mit allen Operatoren, die in Filter-Strings verwendet werden können, finden Sie unter Die Eigenschaft Filter.

Hinweis: Unidirektionale Datenmengen unterstützen keine Filter. Wenn Sie der Eigenschaft Filter einer solchen Datenmenge einen Wert zuweisen, wird eine Exception ausgelöst.

Mit der Eigenschaft FilterOptions kann die Berücksichtigung von Groß-/Kleinschreibung und Teilvergleichen gesteuert werden.

Tipp: Die Filterbedingung kann auch zur Laufzeit geändert werden (beispielsweise als Reaktion auf eine Benutzereingabe).



Beispiel: