Função Sequence
Aplica-se a:
Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI
Gere uma tabela de números sequenciais.
Description
A função Sequence gera uma tabela de coluna única de números sequenciais, como 1, 2, 3. O nome da coluna é Value. Sequence( 4 ) é equivalente a [1,2,3,4].
Use Sequence com a função ForAll para iterar um número específico de vezes. Por exemplo, a fórmula a seguir 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 seguinte fórmula retorna uma tabela dos próximos 10 dias:
ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )
O número de registros a serem gerados é arredondado para o número inteiro mais próximo e deve estar no intervalo de 0 a 50.000. Gerar uma tabela com zero registros resulta em uma tabela vazia.
Nota
Sequence é limitado a 50.000 registros.
Sintaxe
Sequence( Records [, Start [, Step ] ] )
- Records - obrigatório. O número de registros a serem criados. Deve estar no intervalo de 0 a 50.000.
- Start - opcional. O número inicial da sequência. O padrão é 1.
- Step - opcional. O incremento para cada número sucessivo na sequência. Step pode ser negativo para a contagem regressiva a partir de Start. O padrão é 1.
Exemplos
Uso básico
| Fórmula | Descrição | Resultado |
|---|---|---|
| Sequence( 4 ) | Gera uma tabela de 4 registros a partir do padrão 1 e em incrementos do padrão 1. |  |
| Sequence( 4, 24 ) | Gera uma tabela de 4 registros a partir de 24 e com incrementos do padrão 1. |  |
| Sequence( 4, 4, -1 ) | Gera uma tabela de 4 registros a partir de 4 e em incrementos de -1, uma contagem regressiva eficaz. |  |
| Sequence( 4, -100, 0.5 ) | Gera uma tabela de 4 registros a partir de -100 e com incrementos do padrão 0,5. |  |
| Sequence( 0.9 ) | Gera uma tabela vazio conforme a contagem é arredondada para 0. |  |
| ForAll( Sequence( 4 ), Rand() ) | Gera uma tabela de 4 registros de números aleatórios. |  Os números reais variam. |
| Concat( Sequence( 5 ), Text( Value ) & " " ) |
Gera uma sequência 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 funcionam em conjunto para exibir um mapa de caracteres em um layout bidimensional.
Tabuleiro
Consulte a referência do operador As para duas funções Sequence que funcionam em conjunto para criar um tabuleiro de xadrez em uma string de texto e em duas galerias aninhadas.