添加记录

说明

添加一条或者多条记录

语法

表达式：Add(Before, After, Count)

表达式：Records

参数

参数名	是否必需	类型	描述
Before	否	number/string	指定的记录对象（索引从1开始/记录ID），新建的记录将基于此之前
After	否	number/string	指定的记录对象（索引从1开始/记录ID），新建的记录将基于此之后
Count	否	number	插入多少条记录，默认值为1条

返回值

ApiResult

浏览器环境示例

async function example() {
    await instance.ready();
    const app = instance.Application;
    app.Sheets(1).Views(1).Records.Add(undefined, 10, 2) // 在第10行，向下方添加2条记录
    const records = await app.Sheets(1).Views(1).Records.Add(10, undefined, 2) // 在第10行，向上方添加2条记录
    // 在插入的第一条记录的首字段填入 "123"
    records.Item(1, 1).Value = "123"
}

脚本编辑器 示例

function main() {
    const records = Application.Sheets(1).Views(1).Records.Add(10, undefined, 2) // 在第10行，向上方添加2条记录
    // 在插入的第一条记录的首字段填入 "123"
    records.Item(1, 1).Value = "123"
 }
main()