Объекты DIRECTUM > Работа с данными > IQuery – запрос > Метод AddOrderBy – добавить условие сортировки набора данных

Синтаксис:

Параметры:

Condition – условие сортировки набора данных в формате

{[<Псевдоним таблицы>.]<Имя поля>[ desc]}[,...n]

Можно задавать сортировку по любому полю, указанному в разделе select. Псеводним таблицы можно не указывать, если имя поля уникально. Псевдоним таблицы и имя поля можно получить с помощью свойств IObject.TableName, IDataSet.TableName, IField.SQLFieldName, IRequisite.SQLFieldName.

Если в разделе from не указан псеводним таблицы, то вместо него следует использовать имя таблицы. Имя таблицы можно получить с помощью свойств IObject.SQLTableName, IDataSet.SQLTableName.

Если в разделе select указан псевдоним поля, то условие следует задавать в следующем формате:

<Псевдоним поля>[ desc]

Псевдонимы полей, используемые в SQL-запросе набора данных объекта, можно получить с помощью свойства IRequisite.FieldName.

Для формирования параметра удобно использовать функцию Format.

Возвращаемое значение:

Идентификатор условия сортировки в запросе.

Описание:

Метод добавляет условие в раздел order by SQL-запроса. Если раздел order by еще не был определен, то он создается. Если раздел order by уже был определен, то новое условие добавляется в конец раздела. По умолчанию сортировка записей идет по возрастанию. Для сортировки записей по убыванию значений поля надо в условии сортировки указать «desc». Идентификатор условия сортировки в запросе следует использовать в качестве параметра метода DelOrderBy для удаления условия сортировки из запроса.

См. также