Insert Rows Workbook (preview)

Insert Rows Workbook activity that inserts one or more rows into a sheet or range at a specified position.

UiPath.Excel.Activities.InsertRows

描述

Inserts one or more rows into a sheet or range at a specified position. This is the cross-platform equivalent of the Insert Rows Windows activity.

备注：

This activity does not support .xls files.

项目兼容性

Windows | 跨平台

属性

常见

• DisplayName - The name displayed for the activity in the Designer panel.

输入

• 文件- 资源工作簿的完整路径。要切换到本地路径，请选择加号图标，然后选择使用本地文件。当前字段更改为文件（本地路径） ，您可以在其中提供 workbook 的完整路径。
• “工作表名称” - workbook 中工作表的名称。
• Range - The range to insert rows into. If you don't specify a range, the used range of the sheet is used.
• Number Of Rows - The number of rows to insert. The value must be greater than zero. The default value is 1.
• Position - Select where to insert the new rows. The default value is End. You can choose from the following options:
  • Start - Inserts the rows at the beginning of the range.
  • End - Inserts the rows immediately after the last row of the range.
  • Specific index - Inserts the rows at the row index in Specific Row Index.
• Specific Row Index - The 1-based row index, relative to the start of the range, at which to insert the rows. This field is required, and displayed, only when Position is Specific index. If you bind Position to a variable or an expression, the field is always displayed. The value must be at least 1 and not beyond the last row of the range, otherwise the activity fails and nothing is inserted.

选项

• Has Headers - Select this option if the first row of the range is a header row. The header row stays on top, so the rows that you insert at the start go below it. By default, this option is not selected.

  备注：

  Unlike in the Windows Insert Rows activity, Has Headers is not selected by default. When it is not selected, Start inserts the rows at the very first row of the range.

• 密码- workbook 的密码（如有必要）。

使用 workbook

• Workbook - The existing workbook to use instead of a file path.

注意

• The existing rows at and below the insertion point shift down.
• If you don't specify a range, entire sheet rows are inserted, relative to the used range of the sheet. If you specify a range, only the cells in the columns of the range shift down, as in the Windows activity. The cells below the range in those columns move down, and the other columns are not changed.
• Start and Specific index positions are counted from the first row of the range, below the header row when Has Headers is selected.

已知限制

Inserting rows into a table is not supported yet.