插入数据行
功能
在数据表中指定位置插入数据行
输入
| 名称 | 说明 | 示例 |
|---|---|---|
| 数据表 | [DataTable]自定义，要插入数据行的数据表对象。 | 目标数据表 |
| 行索引 | [integer]自定义，要插入指定行位置的索引，为空或者填写0则数据插入至首行 | 1 |
| 数据行 | [DataRow]自定义，要插入到数据表的数据行对象，来源于数据表中某一数据行 | 行对象{填入变量名称} |
| 数组行 | [ArrayRow]自定义，要插入到数据表对象的数组，每个对象的类型应映射到数据表中对应列的类型 | ['体育','100'] |
| 字符串列表 | [List |
列表{填入变量名称} |
输出
| 名称 | 说明 | 示例 |
|---|---|---|
| 数据行 | [DataRow]自定义，输出插入的数据行对象 | 输出行{填入变量名称} |
注意/说明
1.当填写的行索引>=数据表最大行索引，则插入的数据行追加到数据表最后一行。
2.该函数使用的“数据行”、“数组行”和“字符串列表”这三个参数功能相同，设置一个即可插入数据行。若同时设置多个，则只有一个设置有效，有效的优先级为“字符串列表”>"数据行">"数组行"。
3.该函数一般与【对于每一个行】、【构建字符串列表】函数搭配使用。
相关函数
【构建数据表】、【对于每一个行】、【构建字符串列表】、【输出数据表】
示例/演示
使用不同方式插入数据行：
1.使用“数据行”方式插入数据行，一般与【对于每一个行】函数搭配使用
例如：把“数据表2”的数据行插入到“目标数据表”指定位置中。
（1）构建“目标数据表”和“数据表2”：
（2）将“数据表2”的每一行数据都插入到“目标数据表”指定位置中：
（3）插入数据行后，“目标数据表”内容如下图所示：
2.使用“数组行”方式插入数据行
例如：在“目标数据表”指定位置中直接插入数组行数据。
（1）构建“目标数据表”：
（2）直接填写“数组行”参数，将数组数据插入到“目标数据表”指定位置中：
（3）插入数据行后，“目标数据表”内容如下图所示：
3.使用“字符串列表”方式插入数据行，一般与【构建字符串列表】函数搭配使用
例如：在“目标数据表”指定位置中直接插入字符串列表行数据。
（1）构建“目标数据表”：
（2）使用【构建字符串列表】函数构建字符串列表数据：
（3）将列表数据插入到“目标数据表”指定位置中：
（4）插入数据行后，“目标数据表”内容如下图所示：