写入 Excel
组件介绍
在工作表写入或者覆盖内容
截图
属性说明
通用必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入内容 | 字符串 数字 列表 数据表 |
空 | 写入 Excel 的内容 「范围」选择「单元格」时输入内容类型为数字/字符串，如 123 或者 "123"； 「范围」选择「行」/「列」时输入内容类型为列表，如 [1,2,3]； 「范围」选择「区域」时输入内容类型为数据表，如 [[1,2,3]]； 无论写入内容类型是字符串/数字/列表， 在「范围」选择「区域」时则自动将格式转为数据表。 |
| 范围 | 下拉选项 | 区域 | 写入内容的范围： ● 单元格 ● 区域 ● 行 ● 列 |
通用选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 表名 | 字符串 | 空 | 需要操作的工作表名称，为空默认为当前打开的工作表 |
| Excel 对象 | 对象 | 空 | 需要切换的 Excel 文件 「打开 Excel」组件返回值对应的 Excel 文件 空默认为上一个「打开 Excel」组件打开的 Excel 文件 |
区域
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 横向追加：在指定行/列已有内容右侧追加写入 ● 纵向追加： 在指定行/列已有内容下方追加写入 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效， 开始写入的起始单元格地址，如 "A8"， 此属性为空则默认为 "A1" 。 |
| 行号 | 数字/字符串 | 空 | 「写入方式」选择「横向追加」时生效， 开始横向追加写入的行号，如 2。 此属性为空则在有内容的最后一列 的下一列的第一行开始横向写入， 工作表内容为空时则默认为第 1 行。 行号非空则在对应行最后一个有内容单元格 ·的右侧单元格开始横向写入， 此行内容为空时默认从此行第一个单元格开始写入。 |
| 列 | 数字/字符串 | 空 | 「写入方式」选择「纵向追加」时生效， 开始纵向追加写入的列名/列号，如 2。 此属性为空在已有内容最后一行的下一行开始纵向写入， 工作表内容为空时则默认为第 1 列 此属性非空则在指定列最后一个单元格 下方的单元格开始纵向写入 |
单元格
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 横向追加：在指定行/列已有内容右侧追加写入 ● 纵向追加： 在指定行/列已有内容下方追加写入 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效内容 写入的单元格地址，如 "A8"，为空则默认在 A1 写入 |
| 行号 | 数字/字符串 | 空 | 「写入方式」选择「横向追加」时生效 开始横向追加写入的行号，如 2。 行号为空则在有内容的最后一列的下一列的第一行开始横向写入， 工作表为空时则默认为第 1 行； 行号非空则在对应行最后一个有内容单元格 ·的右侧单元格开始横向写入， 此行为空默认从此行第一个单元格开始写入。 |
| 列 | 数字/字符串 | 空 | 「写入方式」选择「纵向追加」时生效， 开始纵向追加写入的列名/列号，如 2 列为空则在已有内容最后一行的下一行开始纵向写入， 工作表内容为空时则默认为第 1 列； 列非空在指定列最后一个单元格下方的单元格开始纵向写入。 |
行
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 追加写入：在已有内容最后一行的下一行写入内容 ● 向上插入：在指定行向上写入内容 ● 向下插入：在指定行向下写入内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效 开始写入的起始单元格地址，如 "A8"， 此属性为空则默认从 A1 开始写入 |
| 行号 | 数字/字符串 | 空 | 「写入方式」选择「向上插入」/「向下插入」时生效 向上/向下写入内容的行号，此属性为空则默认为第 1 行 |
列
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 追加写入：在已有内容最后一列的右侧列写入内容 ● 左侧插入：在指定列向左写入内容 ● 右侧插入：在指定列向右写入内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 列 | 数字/字符串 | 空 | 「写入方式」选择「左侧插入」/「右侧插入」时生效 向左/向右列写入内容的列名/列号，空则默认为第 1 列 |
返回值
无
组件示例
具体内容详见「读取 Excel」组件。
名词解析
具体内容详见「行数」组件。
注意事项
「范围」选择「列」或者「行」时，会将列表中的每个数据从起始单元格开始依次写入。
「范围」选择「区域」时，会将数据表中的内容从起始单元格开始依次写入。
选填项输入的表名不存在会报错，不写默认为当前打开的工作表，可以使用「所有工作表名」组件获取工作表名称。
如果写入的单元格已有内容会覆盖之前的内容。
其他内容详见「打开 Excel」组件。