0

ДеревоЗначений.Строки
Метод Сортировать()

Сортирует строки в коллекции строк дерева значений по указанным правилам

Синтаксис

Метод Сортировать() имеет следующий синтаксис:

Сортировать(Колонки, [ВключатьПодчиненные=Ложь], [ОбъектСравнения])

А также альтернативный англоязычный синтаксис:

Sort(Columns, [IncNested=false], [ComparisonObject])

Параметры

Описание параметров метода Сортировать():

Имя параметра Тип
Описание
Колонки Строка
Список имен колонок дерева значений, разделенных запятыми, по которым должна производится сортировка коллекции. После каждого имени колонки через пробел может быть указано направление сортировки:

Возр Asc — сортировать по возрастанию значений (по умолчанию)
Убыв Desc — сортировать по убыванию значений
ВключатьПодчиненные Булево
Признак определяет, должны ли сортироваться строки в коллекции подчиненных строк (если таковые имеются).
Значение по умолчанию: Ложь.
ОбъектСравнения СравнениеЗначений
Объект для сравнения значений. Реализует сравнение значений, типы которых отличаются от простых (Строка, Число, Дата, Булево)
Жирным шрифтом выделены обязательные параметры

Описание

Метод Сортировать() сортирует строки в коллекции строк дерева значений по указанным правилам. Порядок указания имен колонок дерева значений определяет порядок сортировки. Это означает, что сначала строки сортируются по колонке, указанной первой. Затем группы строк с одинаковым значением в первой колонке сортируются по второй колонке, и так далее.

Если параметр ОбъектСравнения не задан, значения простых типов сравниваются по значению, а значения остальных типов — по строковому представлению.

Если параметр ОбъектСравнения задан,  значения простых типов также сравниваются по значению, а значения остальных типов — по правилам:

  • объекты сравниваются по идентификатору
  • моменты времени сравниваются по дате и идентификатору объекта
  • остальные значения сравниваются по строковому представлению

Доступность

Сервер, толстый клиент, внешнее соединение, мобильное приложение(сервер).

Пример использования

Пример кода с использованием метода Сортировать():

//создание нового дерева значений
ДеревоЗначений = Новый ДеревоЗначений;
//добавим колонки
ДеревоЗначений.Колонки.Добавить("Значение");
ДеревоЗначений.Колонки.Добавить("ТипЗначения");

НоваяСтрока = ДеревоЗначений.Строки.Добавить();
НоваяСтрока.Значение = 1;
НоваяСтрока.ТипЗначения = ТипЗнч(НоваяСтрока.Значение);

НоваяСтрока = ДеревоЗначений.Строки.Добавить();
НоваяСтрока.Значение = "1";
НоваяСтрока.ТипЗначения = ТипЗнч(НоваяСтрока.Значение);

НоваяСтрока = ДеревоЗначений.Строки.Добавить();
НоваяСтрока.Значение = 1.1;
НоваяСтрока.ТипЗначения = ТипЗнч(НоваяСтрока.Значение);

//сортировка с использованием объекта сравнения значений
ДеревоЗначений.Строки.Сортировать("Значение", , Новый СравнениеЗначений);

//Результат:
//	1, 1.1, "1"

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *