Zweck
Setzt eine Bedingung, nach der bestimmte Datensätze des Datenserver ausgeschlossen werden sollen.
Klasse
Typ
Methode
Syntax
<oArrayServer>:SetFilter(
<cFilterCondition>,
[cbFilterCondition]
) Æ lSuccess
<oArrayServer>:SetFilter(<cbFilterCondition>) Æ lSuccess
Argumente
<cFilterCondition> | Bedingung, nach der Datensätze bei nachfolgenden Operationen ausgeschlossen werden sollen. Wird das Argument <cbFilterCondition> nicht angegeben, wird der String in ein _Codeblock-Objekt umgewandelt. Die Umwandlung erfolgt hierbei über den Befehl |
&("{|Server| "+cFilterCondition+"}")
Datentyp: | String |
<cbFilterCondition> | Codeblock, nach dem Datensätze bei nachfolgenden Operationen ausgeschlossen werden sollen. |
Datentyp: | Codeblock | _Codeblock-Objekt |
Rückgabewert
lSuccess | Logischer Wert der definiert, ob der Filter aktiviert werden konnte. |
TRUE | Der Filter wurde aktiviert. |
FALSE | Der Filter konnte nicht aktiviert werden. |
Datentyp: | Logic |
Beschreibung
Über eine Filterbedingung können Datensätze, die nicht der Bedingung entsprechen, von nachfolgenden Datensatz-Operationen ausgeschlossen werden.
Um in der Bedingung <cFilterCondition> bzw. <cbFilterCondition> auf Felder, Zugriffe oder Methoden des Servers zugreifen zu können, muss diesen das Literal "Server" gefolgt von einem Doppelpunkt vorangestellt werden (siehe Beispiel).
Beispiel
Das folgende Beispiel erzeugt einen Filter auf alle Datensätze in denen das Feld LASTNAME mit einem "B" beginnt. Die Bedingung wird als String übergeben.
oasServer:SetFilter("Server:LASTNAME='B'")
Das folgende Beispiel erzeugt einen Filter auf alle Datensätze in denen das Feld LASTNAME mit einem "B" beginnt. Die Bedingung wird als Codeblock übergeben.
oasServer:SetFilter({|Server| Server:LASTNAME="B"})
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?barrayserver_setfilter.htm