Função Table

Aplica-se a: Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI

Cria uma tabela temporária.

Descrição

A função Tabela cria uma tabela de uma lista de argumentos de registros ou tabelas.

As colunas da tabela de resultados são a união de todas as colunas de todos os registros de argumento e tabelas. Um valor em branco é adicionado a qualquer coluna para a qual um registro não inclui um valor.

Uma tabela é um valor no Power Apps, assim como uma cadeia de caracteres ou um número. Você pode especificar uma tabela como um argumento para uma função, e as funções podem retornar uma tabela como um resultado. Table não cria uma tabela permanente. Em vez disso, retorna uma tabela temporária composta por seus argumentos. Você pode especificar essa tabela temporária como um argumento para outra função, visualizá-la em uma galeria ou incorporá-la a outra tabela. Para obter mais informações, consulte Como trabalhar com tabelas.

Você também pode criar uma tabela de coluna única com a sintaxe [ value1, value2, ... ].

Sintaxe

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

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

Table( Untyped )

• Untyped - obrigatório. Objeto sem tipo que representa uma tabela ou matriz. Os valores aceitáveis dependem do provedor 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 como esta fórmula:

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

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

• Adicione uma galeria de texto e defina sua propriedade Items como esta função:
  

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

  A galeria mostra dois registros e ambos contêm o nome e o local de um item. Somente um registro contém o nome do proprietário.

• Esta fórmula integra tamanhos padrão com tamanhos estendidos em uma única tabela

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