Edit

OrderBy Property

  • Article

Version: Available or changed with runtime version 3.0.

Sorts table fields in the page view in ascending or descending order.

Applies to

  • Page View
  • Query

Property Value

Column=Ascending|Descending

  • Column is the name of the query column as specified by its Name Property.

  • Ascending sorts the column from lowest value to the highest value (A to Z, 0 to 9).

  • Descending sorts the column from highest value to the lowest value (Z to A, 9 to 0).

Note

Separate multiple columns with a comma.

Remarks

In the OrderBy property, you add a column by name and set its direction to ascending or descending:

view(MyFirstView)
{
    Caption = 'This is my first view!';
    OrderBy = Ascending (Address);
}

To sort on multiple columns, separate each column with a comma, like OrderBy = ascending (Name), descending (Quantity).

Note

You cannot sort on the same column more than once.

Note

For views you can only use one direction; either Ascending or Descending.

The OrderBy property corresponds to the Order By clause in SQL select statements.

Example

This following table shows the results of a query that retrieves the quantity of items in every open sales order for each customer.

Customer Quantity
The Cannon Group 50
New Concepts 15
New Concepts 30
Selangerian Ltd. 20
Selangerian Ltd. 60

To sort the Customer column in ascending order and the Quantity column to descending order, you set the OrderBy property to Name=Ascending,Quantity=Descending. The following table shows the results of the query after sorting.

Customer Quantity
New Concepts 30
New Concepts 15
Selangerian Ltd. 60
Selangerian Ltd. 20
The Cannon Group 50

The following is the Order By clause in SQL that corresponds to the OrderBy property in this example.

OrderBy = ascending (Name,Quantity);

See Also

Query Properties
View Properties