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 Table cria uma tabela de uma lista de argumentos de registros.

As colunas da tabela serão a união de todas as propriedades de todos os registros de argumento. 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. Consulte Trabalhando com tabelas para obter mais detalhes.

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

Sintaxe

Table( Record1 [, Record2, ... ] )

• Record(s) - obrigatório. Os registros a serem adicionados à tabela.

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. Observe que, independentemente do tipo de conteúdo da Matriz sem tipo, a tabela resultante será 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.