0

ТаблицаЗначений
Метод Сортировать()

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

Синтаксис

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

Сортировать(Колонки, [ОбъектСравнения])

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

Sort(Columns, [ComparisonObject])

Параметры

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

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

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

Описание

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

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

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

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

Доступность

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

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

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

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

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

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

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

//сортировка
тз.Сортировать("Значение", Новый СравнениеЗначений);

//проверка результата
тз.ВыбратьСтроку("Результат сортировки");

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

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