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