Função Table no PowerAppsTable function in PowerApps

Cria uma tabela temporária.Creates a temporary table.

DescriçãoDescription

A função Table cria uma tabela de uma lista de argumentos de registros.The Table function creates a table from an argument list of records.

As colunas da tabela serão a união de todas as propriedades de todos os registros de argumento.The table's columns will be the union of all the properties from all the argument records. Um valor em branco é adicionado a qualquer coluna para a qual um registro não inclui um valor.A blank value is added to any column for which a record doesn't include a value.

Uma tabela é um valor no PowerApps, assim como uma cadeia de caracteres ou um número.A table is a value in PowerApps, just like a string or a number. Você pode especificar uma tabela como um argumento para uma função, e as funções podem retornar uma tabela como um resultado.You can specify a table as an argument for a function, and functions can return a table as a result. Table não cria uma tabela permanente.Table doesn't create a permanent table. Em vez disso, retorna uma tabela temporária composta por seus argumentos.Instead it returns a temporary table made of its arguments. 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.You can specify this temporary table as an argument for another function, visualize it in a gallery, or embed it in another table. Consulte Trabalhando com tabelas para obter mais detalhes.See working with tables for more details.

Você também pode criar uma tabela de coluna única com a sintaxe [valor1, valor2,...] .You can also create a single-column table with the [ value1, value2, ... ] syntax.

SintaxeSyntax

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

  • Record(s) - obrigatório.Record(s) - Required. Os registros a serem adicionados à tabela.The records to add to the table.

ExemplosExamples

  • Defina a propriedade Items de uma caixa de listagem como esta fórmula:Set the Items property of a listbox to this formula:
    Table({Color:"red"}, {Color:"green"}, {Color:"blue"})Table({Color:"red"}, {Color:"green"}, {Color:"blue"})

    A caixa de listagem mostra cada cor como uma opção.The listbox shows each color as an option.

  • Adicione uma galeria de texto e defina sua propriedade Items como esta função:Add a text gallery, and set its Items property to this function:
    Table({Item:"Violin123", Location:"France", Owner:"Fabrikam"}, {Item:"Violin456", Location:"Chile"})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.The gallery shows two records, both of which contain the name and location of an item. Somente um registro contém o nome do proprietário.Only one record contains the name of the owner.