Partilhar via


Função Table

Aplica-se a: Canvas apps Fluxos de área de trabalho CLI de aplicativos Power Platform orientados por modelo

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 tabela 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, ... ] )

  • RecordOrTables - 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.

Tabela( Sem tipo )

  • Não digitado - 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" } )