Функция Sequence
Применимо к:
Приложениям Canvas Потокам рабочего стола Приложениям на основе моделей Power Platform CLI
Формирует таблицу последовательных номеров.
Description
Функция Sequence генерирует таблицу из одного столбца последовательных чисел, таких как 1, 2, 3. Столбец имеет имя Value. Sequence( 4 ) эквивалентно [1,2,3,4].
Используйте функцию Sequence с функцией ForAll для итерации определенное количество раз. Например, следующая формула добавляет 10 случайных чисел в коллекцию MyRandomNumbers:
ForAll( Sequence( 10 ), Collect( MyRandomNumbers, Rand() ) )
ForAll также можно использовать для преобразования значения в другие типы данных и возврата новой таблицы. Например, следующая формула возвращает таблицу следующих 10 дней:
ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )
Количество создаваемых записей округляется вниз до ближайшего целого числа и должно быть в диапазоне от 0 до 50 000. Генерация таблицы с нулевыми записями приводит к пустой таблице.
Заметка
Последовательность ограничена 50 000 записей.
Синтаксис
Последовательность( Записи [, Начало [, шаг ] ] )
- Записи – Обязательно. Количество создаваемых записей. Должно находиться в диапазоне от 0 до 50 000.
- Начало – Необязательно. Начальный номер для последовательности. По умолчанию 1.
- шаг – Необязательно. Приращение для каждого последующего числа в последовательности. шаг может быть отрицательным для обратного отсчета от Старта. По умолчанию 1.
Примеры
Базовое использование
| Формула | Описание | Результат |
|---|---|---|
| Последовательность( 4 ) | Создает таблицу с 4 записями, начиная с 1 по умолчанию и с увеличением на 1 по умолчанию. |  |
| Последовательность( 4, 24 ) | Создает таблицу с 4 записями, начиная с 24 и с увеличением на 1 по умолчанию. |  |
| Последовательность( 4, 4, -1 ) | Создает таблицу с 4 записями, начиная с 4 и с увеличением на -1, что фактически приводит к уменьшению. |  |
| Последовательность( 4, -100, 0.5 ) | Создает таблицу с 4 записями, начиная с -100 и с увеличением на 0,5. |  |
| Последовательность( 0.9 ) | Создает пустую таблица, так как счетчик округляется до 0. |  |
| ДляВсех( Последовательность( 4 ), СЛЧ() ) | Создает таблицу случайных чисел из 4 записей. |  Фактические цифры могут отличаться. |
| Concat( Последовательность( 5 ), Text( Value ) & " " ) |
Создает строку чисел от 1 до 5. | "1 2 3 4 5 " |
Таблица символов
См. справочник по функции Char, где описывается, как две функции Sequence совместно отображают таблицу символов в двумерном формате.
Шахматная доска
См. справочник по оператору As, как две функции Sequence, работающие вместе, создают шахматную доску в текстовой строке и в двух вложенных коллекциях.