写入范围 Workbook

UiPath.Excel.Activities.WriteRange

描述

从“起始单元格”字段中指定的单元格开始，将“数据表”变量中的数据写入电子表格。如未指定起始单元格，则该活动会从 A1 单元格开始写入数据。如果该工作表不存在，则系统会使用“工作表名称”值新建一个工作表。该活动将会覆盖指定范围中的所有单元格。所做更改会立即保存。

备注：

支持的 Workbook 格式为.xls 、 .xlsm 、 .xltm 、 .xlsx和.xltx 。

项目兼容性

旧版 | Windows - Legacy（旧版）| Windows - Legacy（旧版） Windows |跨平台

属性

常见

• “显示名称”- 活动的显示名称。

目标

• SheetName - The name of the sheet in which the range that you want to write to is. By default, this is filled in with "Sheet1." Only String variables and strings are supported.
• “起始单元格”- 要在其中开始写入数据的单元格。仅支持字符串和字符串变量。
  备注：

必须为字符串加上引号。 :::

输入

• “数据表”- 要写入指定范围的数据，为“数据表”变量形式。仅支持“数据表”变量。
• “workbook 路径” - 要使用的 Excel 电子表格的完整路径。该字段接受 IResource 输入。使用加号按钮在“本地文件”和“文件资源”之间切换输入模式。如果要使用的 Excel 文件位于项目文件夹中，则可使用其相对路径。仅支持字符串变量和字符串。
  备注：

或者，当您对同一个文件使用多个 Workbook 活动时，如果不提供文件路径，则可以提高运行时性能，方法是将项目连接到 Data Manager 中的文件，然后使用“workbook”属性引用该文件。:::

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• “添加标头”- 如果选中，则该活动还会将列标头写入指定范围。默认情况下，该复选框是未选中状态。
• “密码”- Excel 工作簿的密码（如有必要）。仅支持字符串和字符串变量。

使用 workbook

• workbook - 从“加号”菜单中选择“workbook”资源。如果您通过连接到 Data Manager 的 workbook 将 Excel 文件添加为资源，则可用。 添加 workbook 资源，然后在多个 workbook 活动中引用该资源，可确保每次操作时不会将文件重新加载到内存中，从而提高运行时性能，尤其是在处理大型文件时。如需更多信息，请参阅“使用数据管理器”。

备注：

存在一个已知问题：在 Excel 文档中，当您尝试向现有的空白工作表写入内容时，该操作有时会失败。