addMemberKey

addMemberKey(propertyName:    String;
             descending:      Boolean;
             caseInsensitive: Boolean) updating;

The addMemberKey method of the DynaDictionary class adds a member key specification to a dynamic dictionary.

If you require multiple keys, call the addMemberKey method to define each key in sequence. To signify that all keys have been defined, call the endKeys method.

Specify a key path by passing a key-path expression in the propertyName parameter; for example, "shipment.supplier.name". Set the descending parameter to true if you want keys sorted in descending order and the caseInsensitive parameter to true if case-sensitivity is not required.

The following preconditions apply when adding keys to a dynamic dictionary.

The appropriate system exception is raised if any of these preconditions are violated.

For an example of the use of the addMemberKey method, see "Using Dynamic Dictionaries", later in this chapter.