bArrayServer:CreateOrder() |
  
|
bArrayServer:CreateOrder() |
|
Zweck
Erzeugt eine neue Sortierung auf die Daten.
Klasse
Typ
Methode
Syntax
<oArrayServer>:CreateOrder(
<uExpression>,
[<uForCondition>],
[<uWhileCondition>],
[<lDescend>],
[<cbEval>],
[<iInterval>]
) Æ lSuccess
Argumente
| <uExpression> | Ausdruck nach dem die Sortierung erzeugt werden soll. Wird der Ausdruck als String angegeben, wird dieser automatisch in ein _Codeblock-Objekt umgewandelt. Die Umwandlung erfolgt hierbei über den Befehl |
&("{|Server| "+uExpression+"}")
Anmerkungen
Nur wenn der Ausdruck als String definiert wird, kann dieser mit der Methode bArrayServer:OrderInfo(DBOI_EXPRESSION) wieder ermittelt werden. Bei einem Codeblock ist dies nicht möglich. In diesem Fall wird ein NULL_STRING zurückgegeben.
| Datentyp: | String | Codeblock | _Codeblock |
| <uForCondition> | Bedingung, die jeder Datensatz erfüllen muss, damit er in die Sortierung aufgenommen wird. Erfüllt ein Datensatz die angegebene Bedingung nicht, wird er ignoriert und der nächste Datensatz verarbeitet. Wird die Bedingung als String angegeben, wird dieser automatisch in ein _Codeblock-Objekt umgewandelt. Die Umwandlung erfolgt hierbei über den Befehl |
&("{|Server| "+uForCondition+"}")
Als Vorgabe wird der Wert NIL verwendet.
| Datentyp: | String | Codeblock | _Codeblock |
| <uWhileCondition> | Bedingung, die jeder Datensatz erfüllen muss, damit er in die Sortierung aufgenommen wird. Sobald ein Datensatz gefunden wird, der die Bedingung nicht erfüllt, wird der Aufbau der Sortierung beendet. Wird die Bedingung als String angegeben, wird dieser automatisch in ein _Codeblock-Objekt umgewandelt. Die Umwandlung erfolgt hierbei über den Befehl |
&("{|Server| "+uWhileCondition+"}")
Die WHILE-Bedingung wird nur zum Erstellen der Sortierung benutzt. Sie wird nicht für die Aktualisierung verwendet. Als Vorgabe wird der Wert NIL verwendet.
| Datentyp: | String | Codeblock | _Codeblock |
| <lDescend> | Logischer Wert der definiert, ob die Sortierung aufsteigend (FALSE) oder absteigend (TRUE) aufgebaut werden soll. |
| Datentyp: | Logic |
| <cbEval> | Codeblock, der alle <iIntervall>-Schritte ausgewertet wird. Damit kann z.B. der Fortschritt des Sortiervorgangs angezeigt werden. Der Rückgabewert von <cbEval> muss ein logischer Wert sein. Gibt <cbEval> FALSE zurück, wird der Sortiervorgang beendet. Als Vorgabe wird der Wert NIL verwendet. |
| Datentyp: | Codeblock | _Codeblock |
| <iInterval> | Numerischer Wert, der die Anzahl der Aufrufe von <cbEval> festlegt. Dies beschleunigt den Sortiervorgang, da der Codeblock in Intervallen und nicht einzeln für jeden Datensatz ausgewertet wird. Damit der Codeblock bei jedem Datensatz ausgewertet wird, muss der Wert 0 angeben werden. Als Vorgabe wird der Wert 0 verwendet. |
| Datentyp: | DWord |
Rückgabewert
| lSuccess | Logischer Wert der definiert, ob die Sortierung erzeugt werden konnte. |
| TRUE | Die Sortierung wurde erzeugt. |
| FALSE | Die Sortierung konnte nicht erzeugt werden. |
| Datentyp: | Logic |
Beschreibung
Über eine Sortierung kann die logische Reihenfolge der Datensätze geändert werden.
Bevor die Sortierung aufgebaut wird, sendet der Datenserver eine NotifyIntentToMove-Nachricht und ruft anschließend die Methode bArrayServer:Commit() auf.
Um in dem Ausdruck <uExpression> und den Bedingungen <uForCondition> bzw. <uWhileCondition> 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 eine Sortierung auf die Felder LASTNAME und FIRSTNAME. Der Ausdruck wird als String übergeben.
oasServer:CreateOrder("Server:LASTNAME+Server:FIRSTNAME")
Das folgende Beispiel erzeugt eine Sortierung auf die Felder LASTNAME und FIRSTNAME. Der Ausdruck wird als Codeblock übergeben.
oasServer:CreateOrder({|Server|Server:LASTNAME+Server:FIRSTNAME})
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?barrayserver_createorder.htm