ТаблицаЗначений / ValueTable

Объект для работы с данными в табличном виде. Представляет из себя коллекцию строк с заранее заданной структурой.

Свойства

Колонки / Columns

Доступ: Чтение

Коллекция колонок

Индексы / Indexes

Доступ: Чтение

Коллекция индексов

Методы

Количество / Count()

Количество строк в Таблице значений

Возвращаемое значение

Число

Добавить / Add()

Добавляет строку в конец Таблицы значений

Возвращаемое значение

СтрокаТаблицыЗначений

Вставить / Insert()

Вставляет строку в указанную позицию

Параметры

  • index: Число - Индекс позиции куда будет произведена вставка

Возвращаемое значение

СтрокаТаблицыЗначений

Удалить / Delete()

Удаляет строку

Параметры

  • Row: СтрокаТаблицыЗначений - Удаляемая строка Число - Индекс удаляемой строки

ЗагрузитьКолонку / LoadColumn()

Загружает значения в колонку

Параметры

  • Values: Массив - Значения для загрузки в колонку

  • ColumnIndex: Строка - Имя колонки для загрузки Число - Индекс колонки для загрузки КолонкаТаблицыЗначений - Колонка для загрузки

ВыгрузитьКолонку / UnloadColumn()

Выгружает значения колонки в новый массив

Параметры

  • Column: Строка - Имя колонки для выгрузки Число - Индекс колонки для выгрузки КолонкаТаблицыЗначений - Колонка для выгрузки

Возвращаемое значение

Массив

ЗаполнитьЗначения / FillValues()

Заполнить колонку/колонки указанным значением

Параметры

  • Value: Произвольный - Устанавливаемое значение

  • ColumnNames: Строка - Список имен колонок для установки значения (разделены запятыми)

Индекс / IndexOf()

Получить индекс указанной строки

Параметры

  • Row: СтрокаТаблицыЗначений - Строка таблицы значений, для которой необходимо определить индекс

Возвращаемое значение

Число - Индекс в коллекции, если не найдено возвращает -1

Итог / Total()

Сумма значений всех строк указанной колонки

Параметры

  • ColumnIndex: Строка - Имя колонки для суммирования Число - Индекс колонки для суммирования КолонкаТаблицыЗначений - Колонка для суммирования

Возвращаемое значение

Число

Найти / Find()

Осуществляет поиск значения в указанных колонках

Параметры

  • Value: Произвольный - Искомое значение

  • ColumnNames: Строка - Список имен колонок для поиска значения (разделены запятыми). Если параметр не указан - ищет по всем колонкам. По умолчанию: пустая строка

Возвращаемое значение

СтрокаТаблицыЗначений - если строка найдена, иначе Неопределено

НайтиСтроки / FindRows()

Поиск строк по условию

Параметры

  • Filter: Структура - Условия поиска. Ключ - имя колонки, значение - искомое значение

Возвращаемое значение

Массив - Массив ссылок на строки, удовлетворяющих условию поиска

Очистить / Clear()

Удаляет все строки. Структура колонок не меняется.

Получить / Get()

Получить строку по индексу

Параметры

  • index: Число - Индекс строки

Возвращаемое значение

СтрокаТаблицыЗначений

Свернуть / GroupBy()

Сворачиваются (группируются) строки по указанным колонкам измерениям, суммируются колонки ресурсов. Колонки не указанные ни в измерениях ни в ресурсах удаляются.

Параметры

  • GroupColumnNames: Строка - Имена колонок для сворачивания (изменения), разделены запятыми

  • AggregateColumnNames: Строка - Имена колонок для суммирования (ресурсы), разделены запятыми

Сдвинуть / Move()

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

Параметры

  • Row: СтрокаТаблицыЗначений - Строка которую сдвигаем Число - Индекс сдвигаемой строки

  • Offset: Количество строк, на которое сдвигается строка. Если значение положительное - сдвиг вниз, иначе вверх

СкопироватьКолонки / CopyColumns()

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

Параметры

  • ColumnNames: Строка - Имена колонок для копирования, разделены запятыми

Возвращаемое значение

ТаблицаЗначений

Скопировать / Copy()

Создает новую таблицу значений с указанными строками и колонками. Если передан отбор - копирует строки удовлетворяющие отбору. Если не указаны строки - будут скопированы все строки. Если не указаны колонки - будут скопированы все колонки. Если не указаны оба параметра - будет создана полная копия таблицы значений.

Параметры

  • Rows: Массив - Массив строк для отбора Структура - Параметры отбора. Ключ - Колонка, Значение - Значение отбора

  • ColumnNames: Строка - Имена колонок для копирования, разделены запятыми

Возвращаемое значение

ТаблицаЗначений

Сортировать / Sort()

Сортировать строки в таблице значений. Строки сортируются по порядку следования колонок для сортировки, с учетом варианта сортировки.

Параметры

  • columns: Строка - Имена колонок для сортировки. После имени колонки, через пробел, можно указать направление сортировки: "Убыв" ("Desc") - по убыванию. Возр" ("Asc") - по возрастанию По умолчанию - по возрастанию.

  • comparator: СравнениеЗначений - правила сравнения значений при наличии различных типов данных в колонке.

ВыбратьСтроку / ChooseRow()

Не поддерживается

Параметры

  • title:
  • startRow:

Конструкторы

По умолчанию