Объекты DIRECTUM

 

Объект IQuery

 

Метод AddOrderBy – добавить условие сортировки набора данных

Синтаксис:

Параметры:

Condition – условие сортировки набора данных в формате <Имя таблицы>.<Имя поля>[ desc]. Можно задавать сортировку по любому полю, указанному в разделе select. Имя таблицы и имя поля можно получить с помощью свойств IObject.SQLTableName, IDataSet.SQLTableName, IRequisite.SQLFieldName, IField.SQLFieldName.

Если в разделе from указан алиас таблицы, то условие следует задавать в формате: <Алиас таблицы>.<Имя поля>[ desc]. Алиасы таблиц, используемые в SQL-запросе набора данных, можно получить с помощью свойств IObject.TableName, IDataSet.TableName.

Если в разделе select указан алиас поля, то условие следует задавать в формате <Алиас поля>[ desc]. Алиасы полей, используемые в SQL-запросе набора данных, можно получить с помощью свойств IRequisite.FieldName, IField.Name.

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

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

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

Описание:

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

 

 

См. также:

·         метод DelOrderBy;

·         свойство IDataSet.SQLTableName;

·         свойство IDataSet.TableName;

·         свойство IField.Name;

·         свойство IField.SQLFieldName;

·         свойство IObject.SQLTableName;

·         свойство IObject.TableName;

·         свойство IRequisite.FieldName;

·         свойство IRequisite.SQLFieldName.