Função Sequence
Aplica-se a:
Canvas apps Fluxos de área de trabalho CLI de aplicativos Power Platform orientados por modelo
Gere uma tabela de números sequenciais.
Descrição
A função Sequence gera uma única tabela de colunas de números sequenciais, tais como 1, 2, 3. O nome da coluna é Value. Sequence( 4 ) é equivalente a [1,2,3,4].
Utilize Sequence com a função ForAll para iterar um número de vezes específico. Por exemplo, a seguinte fórmula adiciona 10 números aleatórios à coleção MyRandomNumbers:
ForAll( Sequence( 10 ), Collect( MyRandomNumbers, Rand() ) )
ForAll também pode ser usado para transformar o valor em outros tipos de dados e retornar uma nova tabela. Por exemplo, a fórmula seguinte devolve uma tabela dos 10 dias seguintes:
ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )
O número de registos a gerar é arredondado para o número inteiro mais próximo e tem de estar entre 0 e 50.000. Gerar uma mesa com zero registos resulta numa tabela vazia.
Nota
A sequência é limitada a 50.000 registros.
Sintaxe
Sequência( Registros [, Start [, passo ] )
- Registos – Obrigatório. O número de registos a criar. Tem de estar no intervalo de 0 a 50.000.
- Iniciar – Opcional. O número inicial para a sequência. A predefinição é 1.
- passo – Opcional. O incremento para cada número sucessivo na sequência. passo pode ser negativo para contagem regressiva desde o início. A predefinição é 1.
Exemplos
Utilização básica
| Fórmula | Descrição | Resultado |
|---|---|---|
| Sequência( 4 ) | Gera uma tabela de 4 registos a partir do valor predefinido de 1 e com incremento de 1 por predefinição. |  |
| Sequência( 4, 24 ) | Gera uma tabela de 4 registos a partir de 24 e com incremento de 1 por predefinição. |  |
| Sequência( 4, 4, -1 ) | Gera uma tabela de 4 registos a partir do valor de 4 e com incremento de -1, uma contagem decrescente efetiva. |  |
| Sequência( 4, -100, 0.5 ) | Gera uma tabela de 4 registos a partir de -100 e com incremento de 0,5. |  |
| Sequência( 0,9 ) | Gera uma tabela vazia porque a contagem é arredondada para 0. |  |
| ForAll( Sequência( 4 ), Rand() ) | Gera uma tabela de 4 registos de números aleatórios. |  Os números reais variam. |
| Concat( Sequência( 5 ), Text( Value ) & " " ) |
Gera uma cadeia de números de 1 a 5. | "1 2 3 4 5 " |
Mapa de caracteres
Consulte a referência da função Char para duas funções Sequence que trabalham em conjunto para apresentar um mapa de caracteres num esquema bidimensional.
Tabuleiro de Xadrez
Consulte a referência do operador As para duas funções Sequence que trabalham em conjunto para criar um tabuleiro de xadrez numa cadeia de texto e em duas galerias aninhadas.