Função Sequence

Aplica-se a: Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos 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

A sequência é limitada a 50.000 registros.

Sintaxe

Sequência( Registros [, Início [, etapa ] ] )

• Registros – Obrigatório. O número de registros a serem criados. Deve estar no intervalo de 0 a 50.000.
• Iniciar – Opcional. O número inicial da sequência. O padrão é 1.
• etapa – Opcional. O incremento para cada número sucessivo na sequência. etapa pode ser negativo para contagem regressiva a partir do Início. O padrão é 1.

Exemplos

Uso básico

Fórmula	Descrição	Resultado
Sequência( 4 )	Gera uma tabela de 4 registros a partir do padrão 1 e em incrementos do padrão 1.
Sequência( 4, 24 )	Gera uma tabela de 4 registros a partir de 24 e com incrementos do padrão 1.
Sequência( 4, 4, -1 )	Gera uma tabela de 4 registros a partir de 4 e em incrementos de -1, uma contagem regressiva eficaz.
Sequência( 4, -100, 0,5 )	Gera uma tabela de 4 registros a partir de -100 e com incrementos do padrão 0,5.
Sequência( 0,9 )	Gera uma tabela vazio conforme a contagem é arredondada para 0.
ForAll( Sequência( 4 ), Rand() )	Gera uma tabela de 4 registros de números aleatórios.	Os números reais podem variar.
Concat( Sequência( 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.