Сортирует строки в коллекции строк дерева значений по указанным правилам
Синтаксис
Метод Сортировать()
имеет следующий синтаксис:
Сортировать(Колонки, [ВключатьПодчиненные=Ложь], [ОбъектСравнения])
А также альтернативный англоязычный синтаксис:
Sort(Columns, [IncNested=false], [ComparisonObject])
Параметры
Описание параметров метода Сортировать()
:
Имя параметра* | Тип | Описание | ||||
---|---|---|---|---|---|---|
Колонки | Строка | Список имен колонок дерева значений, разделенных запятыми, по которым должна производится сортировка коллекции. После каждого имени колонки через пробел может быть указано направление сортировки:
|
||||
ВключатьПодчиненные | Булево | Признак определяет, должны ли сортироваться строки в коллекции подчиненных строк (если таковые имеются). Значение по умолчанию: Ложь. |
||||
ОбъектСравнения | СравнениеЗначений | Объект для сравнения значений. Реализует сравнение значений, типы которых отличаются от простых (Строка, Число, Дата, Булево) | ||||
*Жирным шрифтом выделены обязательные параметры |
Описание
Метод Сортировать()
сортирует строки в коллекции строк дерева значений по указанным правилам. Порядок указания имен колонок дерева значений определяет порядок сортировки. Это означает, что сначала строки сортируются по колонке, указанной первой. Затем группы строк с одинаковым значением в первой колонке сортируются по второй колонке, и так далее.
Если параметр ОбъектСравнения
не задан, значения простых типов сравниваются по значению, а значения остальных типов — по строковому представлению.
Если параметр ОбъектСравнения
задан, значения простых типов также сравниваются по значению, а значения остальных типов — по правилам:
- объекты сравниваются по идентификатору
- моменты времени сравниваются по дате и идентификатору объекта
- остальные значения сравниваются по строковому представлению
Доступность
Версия | Поддержка |
---|---|
8.1 | Сервер, Клиент, Внешнее соединение |
8.2 | Сервер, Толстый клиент, Внешнее соединение |
8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода Сортировать()
:
//создание нового дерева значений ДеревоЗначений = Новый ДеревоЗначений; //добавим колонки ДеревоЗначений.Колонки.Добавить("Значение"); ДеревоЗначений.Колонки.Добавить("ТипЗначения"); НоваяСтрока = ДеревоЗначений.Строки.Добавить(); НоваяСтрока.Значение = 1; НоваяСтрока.ТипЗначения = ТипЗнч(НоваяСтрока.Значение); НоваяСтрока = ДеревоЗначений.Строки.Добавить(); НоваяСтрока.Значение = "1"; НоваяСтрока.ТипЗначения = ТипЗнч(НоваяСтрока.Значение); НоваяСтрока = ДеревоЗначений.Строки.Добавить(); НоваяСтрока.Значение = 1.1; НоваяСтрока.ТипЗначения = ТипЗнч(НоваяСтрока.Значение); //сортировка с использованием объекта сравнения значений ДеревоЗначений.Строки.Сортировать("Значение", , Новый СравнениеЗначений); //Результат: // 1, 1.1, "1"