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.

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

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

Sintaxe

Table( Registo1 [, Registo2,... ] )

  • Record(s) – Obrigatório. Os registos a adicionar à tabela.

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. Note 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 para esta fórmula:
    Table({Color:"vermelho"}, {Color:"verde"}, {Color:"azul"})

    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:"Violino123", Localização:"França", Proprietário:"Fabrikam"}, {Item:"Violino456", Localização:"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.