Table.InsertRows

Insere uma lista de linhas na tabela na posição especificada.

Syntax

Table.InsertRows(
    table as table,
    offset as number,
    rows as list
) as table

Remarks

Devolve uma tabela com a lista de linhas, rows, inserida em table na posição especificada, offset. Cada coluna existente na linha a inserir tem de corresponder aos tipos de coluna da tabela.

Examples

Example #1

Inserir a linha na tabela na posição 1.

Table.InsertRows(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"]
    }),
    1,
    {[CustomerID = 3, Name = "Paul", Phone = "543-7890"]}
)

Result:

Table.FromRecords({
    [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 2, Name = "Jim", Phone = "987-6543"]
})

Example #2

Inserir duas linhas na tabela na posição 1.

Table.InsertRows(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    1,
    {
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"]
    }
)

Result:

Table.FromRecords({
    [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
    [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})

Category

Table.Row operations