Get the key value of the current record from the controlling order.
XSharp.RT (in XSharp.RT.dll) Version: 2.2a
Syntax View Source
uOrder AS USUAL,
cIndexFile AS USUAL
) AS USUAL
public static Usual OrdKeyVal(
[DefaultParameterValueAttribute(0, 1)] Usual uOrder,
[DefaultParameterValueAttribute(0, 1)] Usual cIndexFile
- Type: Usual
- Type: Usual
The current record's key value. The data type of the return value is the same as the that of the key expression used to create the order. Use ValType() or UsualType() to determine the data type.
OrdKeyVal() returns NIL if:
The is no controlling order
The record pointer is at the end-of-file (EOF() returns TRUE)
There is no key defined for this record (for example, you have positioned the record pointer to a record that does not meet the order's for condition or that lies outside of its specified scope)
The key value is retrieved from the controlling order, not the database file. This makes the retrieval faster because no time is spent reading in the actual record.
Tip: OrdKeyVal() is fast, but if you are going to use the value more than once, it is faster to store the result in a local variable. Then use the local variable rather than calling OrdKeyVal() repeatedly for the same record.
By default, this function operates on the currently selected work area. It can be made to operate on an unselected work area by specifying it within an aliased expression
This example displays the values for all keys in an order without ever reading the individual records into memory:
LOCAL cKey, cFirst, cLast
// Assuming both LastName and FirstName are
// 20 characters
INDEX ON LastName + FirstName TO lastfir
DO WHILE !Customer->EOF()
cKey := Customer->OrdKeyVal() // Get key
cLast := LEFT(cKey, 20) // Get last
cFirst := RIGHT(cKey, 20) // Get first
? cLast, cFirst