Метод DoCmd.SetOrderBy (Access)

Используйте метод SetOrderBy , чтобы применить сортировку к активной таблице, форме, отчету или таблице.

Синтаксис

expression. SetOrderBy (OrderBy, ControlName)

expression: переменная, представляющая объект DoCmd.

Параметры

Имя Обязательный или необязательный Тип данных Описание
OrderBy Обязательный Variant Строковое выражение, включающее имя поля или полей, по которым сортируются записи, и необязательные ключевые слова ASC или DESC.
ControlName Необязательный Variant Если указан и активный объект является формой или отчетом, имя элемента управления, соответствующее подчиненной форме или вложенного отчета, которые будут отсортированы. Если пуст и активный объект является формой или отчетом, родительская форма или отчет сортируется.

Замечания

При выполнении этого метода сортировка применяется к таблице, форме, отчету или таблице (например, результату запроса), которые являются активными и имеют фокус.

Аргумент OrderBy — это имя поля или полей, по которым требуется сортировать записи. Если вы используете несколько имен полей, разделите имена запятыми (,). Свойство OrderBy активного объекта используется для сохранения упорядоченного значения и его последующего применения. Значения OrderBy сохраняются вместе с объектами, в которых они создаются. Они автоматически загружаются при открытии объекта, но не применяются автоматически.

При установке аргумента OrderBy путем ввода одного или нескольких имен полей и последующего выполнения метода записи сортируются по умолчанию в порядке возрастания.

Чтобы отсортировать записи по убыванию, введите DESC в конце выражения аргумента OrderBy . Например, чтобы отсортировать записи клиентов в порядке убывания по имени контакта, задайте для аргумента OrderBy значение ContactName DESC. Чтобы отсортировать имена по убыванию LastName и FirstName по возрастанию, задайте для аргумента OrderBy значение LastName DESC, FirstName ASC.

Пример

В следующем примере кода активная таблица, форма, отчет или таблица сортируются по убыванию LastName и по возрастанию FirstName.

DoCmd.SetOrderBy "LastName DESC, FirstName ASC"

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.