Table.InsertRows

วากยสัมพันธ์

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

ประมาณ

ส่งกลับตารางที่มีรายการของแถว rows, แทรกเข้าไปใน table ในตําแหน่งที่กําหนด offset แต่ละคอลัมน์ในแถวที่จะแทรกจะต้องตรงกับชนิดคอลัมน์ของตาราง

ตัวอย่างที่ 1

แทรกแถวลงในตารางที่ตําแหน่ง 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"]}
)

ผลลัพธ์ของ

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

ตัวอย่างที่ 2

แทรกสองแถวลงในตารางที่ตําแหน่ง 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"]
    }
)

ผลลัพธ์ของ

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