The SortByExisting property specifies the property by which the collection sorts objects.
DUOSObjects.SortByExisting [= property_name]
• DUOSObjects – A collection of data objects in the DUOS.
• property_name – The property used for the sort operation.
Use the SortByExisting property to sort the objects in a collection by the value of a given property. In the following example, the SortByExisting property sorts the data objects in the Customers collection by the Date Added property:
Collection Name |
Object ID |
Property name |
Property value |
---|---|---|---|
Customers |
C001 C005 |
Date Added |
03/22/96 |
Date Added |
01/04/96 |
||
URL Address |
www.afitz.com |
||
C002 |
Date Added |
12/18/95 |
|
URL Address |
www.altonmfg.com |
||
C001 |
Date Added |
04/13/95 |
In this case, the items are sorted in ascending order starting with the most recent date. If the property_name exists only for a subset of objects in the collection, the collection will be restricted to that subset of objects. In the following example, the SortByExisting method sorts by the URL Address property:
Collection name |
Object ID |
Property name |
Property value |
---|---|---|---|
Customers |
C005 |
Date Added |
01/04/96 |
URL Address |
www.afitz.com |
||
C002 |
Date Added |
12/18/95 |
|
URL Address |
www.altonmfg.com |