Função Table

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Cria uma tabela temporária.

Descrição

A função Table cria uma tabela a partir de uma lista de argumentos de registos ou tabelas.

As colunas da tabela de resultados são a união de todas as colunas de todos os registos e tabelas de argumentos. O valor blank é adicionado a qualquer coluna para a qual um registo não inclua um valor.

Uma tabela é um valor no Power Apps, tal como uma cadeia ou um número. Pode especificar uma tabela como um argumento para uma função e as funções podem devolver uma tabela como um resultado. A função Table não cria uma tabela permanente. Em vez disso, devolve uma tabela temporária constituída pelos respetivos argumentos. Pode especificar esta tabela temporária como um argumento para outra função, visualizá-la numa galeria ou incorporá-la noutra tabela. Para obter mais informações, consulte trabalhar com tabelas.

Também pode criar uma tabela de coluna única com a sintaxe [ valor1, valor2,... ].

Sintaxe

Tabela( RecordOrTable1 [, RecordOrTable2, ... ] )

• RecordOrTable(s) – Obrigatório. Os registos ou a tabela a adicionar à tabela de resultados. Se for fornecida uma tabela, os registos da tabela são adicionados à tabela resultante como se tivessem sido adicionados individualmente.

Table( Untyped )

• Sem tipo – Obrigatório. Objeto sem tipo que representa uma tabela ou matriz. Os valores aceitáveis dependem do fornecedor sem tipo. Para JSON, espera-se que o objeto sem tipo seja uma matriz JSON. Independentemente do tipo de conteúdo da matriz Sem tipo, a tabela resultante é uma tabela de coluna única de Objetos sem tipo.

Exemplos

• Defina a propriedade Items de uma caixa de listagem para esta fórmula:

  Table( {Color: "red"}, {Color: "green"}, {Color: "blue" } )
  

  A caixa de listagem apresenta cada cor como uma opção.

• Adicione uma galeria de texto e defina a respetiva propriedade Items para esta função:
  

  Table( {Item: "Violin123", Location:"France", Owner:"Fabrikam"}, {Item:"Violin456", Location:"Chile"} )
  

  A galeria apresenta dois registos que contêm o nome e a localização de um item. Apenas um registo contém o nome do proprietário.

• Esta fórmula combina tamanhos padrão com tamanhos alargados numa única tabela

  Table( { Value: "XS" }, [ "S", "M", "L" ], { Value: "XL" } )