0

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

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

Синтаксис

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

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

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

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

Параметры

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

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

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

Описание

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

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

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

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

Доступность

Версия Поддержка
8.1 Сервер, Клиент, Внешнее соединение
8.2 Сервер, Толстый клиент, Внешнее соединение
8.3 Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение

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

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

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

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

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

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

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

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

Читайте также:

  1. Дерево значений 1с. Описание и примеры использования

Поделиться страницей в соц.сетях

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

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