Zweck
Ermittelt ein 2-spaltiges Array mit Feldwerten vom Datenserver.
Klasse
Typ
Methode
Syntax
<oArrayServer>:GetLookupTable(
[<iMaxRows>],
[<uField1>],
[<uField2>],
[<uSearchValue>]
) Æ auValue
Argumente
<iMaxRows> | Die maximale Anzahl von Zeilen, die in dem Array zurückgegeben werden sollen. Als Vorgabe werden 100 Zeilen zurückgegeben. |
Datentyp: | DWord |
<uField1> | Nummer, Name oder Symbol des Feldes, das in der ersten Spalte des Arrays zurückgegeben werden soll. Als Vorgabewert wird das erste Feld im Datenserver verwendet. |
Datentyp: | DWord | String | Symbol |
<uField2> | Nummer, Name oder Symbol des Feldes, das in der zweiten Spalte des Arrays zurückgegeben werden soll. Als Vorgabewert wird das zweite Feld im Datenserver verwendet. |
Datentyp: | DWord | String | Symbol |
<uSearchValue> | Wert, der in der aktiven Sortierung gesucht werden soll. Der Datenserver ruft hierzu die Methode bArrayServer:Seek() auf. Ab dem gefundenen Datensatz wird das Array gefüllt. |
Datentyp: | Usual |
Rückgabewert
auValue | Ein 2-spaltiges Array mit den ermittelten Feldwerten. |
Datentyp: | Array |
Beschreibung
bArrayServer:GetLookupTable() gibt ein 2-spaltiges Array von Feldwerten zu den spezifizierten Feldern zurück. Der Datenserver wird sequentiell bis zur maximalen Anzahl von Datensätzen durchlaufen oder bis der Datensatzzeiger hinter dem letzten Datensatz steht (siehe auch bArrayServer:EoF).
Ein aktiver Filter, ein Scope oder eine selektive Relation werden berücksichtigt. Falls eine Sortierung aktiv ist, wird das Array unter dieser Sortierung gefüllt.
Anmerkungen
Die Methode positioniert den Datenserver nicht auf den ersten Datensatz, sondern beginnt die Operation mit dem aktuellen Datensatz oder dem, der durch das Argument <uSearchValue> gefunden wurde.
Am Anfang der Operation sendet der Datenserver eine NotifyIntentToMove-Nachricht und am Ende eine NotifyRecordChange-Nachricht. Der Datenserver steht nach der Operation auf dem letzten bearbeiteten Datensatz oder auf End of File (siehe auch bArrayServer:EoF).
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?barrayserver_getlookuptable.htm