对每个 Excel 行

UiPath.Excel.Activities.Business.ExcelForEachRow

对范围、表格或工作表中的每一行执行一个或多个活动。该活动可以与为父级“使用 Excel 文件”活动选择的 Excel 文件一起使用，也可以与“项目笔记本”一起使用。

当您处理包含多个行的范围或工作表，并且希望为每个单独的工作表重复一个或多个活动时，请使用此活动。在“遍历 Excel 中的每一行”中设置要重复的活动，并在配置活动时从加号菜单中选择“当前行”以指明要对迭代中的每一行重复操作。

对于大多数活动，您还必须从每一行中选择要使用的特定列。要了解可用于根据您选择的范围指定列的选项，请参阅范围选择的工作原理。您还可以使用“当前行”下的“在 Excel 中指明”选项指定列。在这种情况下，您可以直接从文件中选择要使用的列中的任何单元格。

要了解如何使用此活动，请参阅：

• 教程：遍历表中的行
• 教程：使用 Word 自动化。

配置活动

在活动正文中

• “遍历循环”- 输入引用当前迭代的名称。在配置“遍历 Excel 中的每一行”中添加的活动时，使用描述范围中行的名称可以更轻松地识别和选择迭代中的当前行。例如，对于每一行都包含不同供应商信息的范围，您可以输入“Supplier”。默认值为 CurrentRow。

  将两个“遍历 Excel 中的每一行”活动互相添加至另一个活动时，如果两者的此名称相同，则子活动菜单的“加号”中仅显示最近的一个选项。

• 在范围内 - 单击字段右侧的加号，选择文件，然后选择要使用的指定范围、表格或工作表，或者选择“在 Excel 中指明”以打开文件并直接从文件中选择一个范围。或者，也可以选择“自定义输入”以手动输入范围、表格名称或工作表名称，或选择“在高级编辑器中打开”以输入 VB 表达式。
• “含标头”- 如果选中，则表示范围中的第一行是标头行。当您配置在“遍历 Excel 中的每一行”中添加的活动时，您可以通过列标头轻松识别要从当前行中选择的数据。
• “在每行后保存”- 如果选中，则系统在处理迭代中的每一行后，会在项目执行期间保存 Excel 文件。如果未选择，则系统仅在处理完迭代中的所有行后才保存文件。默认情况下未选中此选项。

属性面板

常见

• “显示名称”- 设计器面板中活动的显示名称

其他

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

选项

• “空行行为”- 选择遇到空行时自动化的行为方式：

  • “在连续三个空行后停止”- 在出现三个连续的空行后停止迭代。这是默认选项。
  • “停止”- 停止遍历行。
  • “跳过”- 跳过空行并移至下一行。
  • “处理”- 处理空行。
• “有标题”- 在活动主体中查看“有标题”。
• “在范围内”- 请在活动主体中查看“在范围内”。
• “保存每一行”- 请在活动主体中查看“保存每一行”。

范围选择的工作原理

StudioX 用于以各种方式定义“遍历 Excel 中的每一行”活动的目标范围。以下信息说明了“在范围内”活动中的不同选择如何影响“遍历 Excel 中的每一行”中添加的活动使用的范围，以及可用于指定在当前行使用哪一列的选项。

整个工作表

选择示例: [Excel]Sheet1

• “使用的范围”：工作表中存在数据的所有行。

• 当前行选项：

  • 如果在“遍历 Excel 中的每一行”中选择了“含标头”，则该选项为工作表第 1 行内的值。
  • 如果未在“遍历 Excel 中的每一行”中选择“含标头”，则该选项为列字母（A、B、C 等）。

表格

选择示例: [Excel]Sheet1!Table1

• “使用的范围”：所选表格中的所有行。
• “当前行选项”：无论是否在“遍历 Excel 中的每一行”中选择了“含标头”，表格标头中的都是该值。

指定范围

选择示例: [Excel]Sheet1!Range1

• “使用的范围”：所选范围内的所有行。
• 当前行选项：
  • 如果在“遍历 Excel 中的每一行”中选择了“含标头”，则该选项为范围中第 1 行内的值。
  • 如果未在“遍历 Excel 中的每一行”中选择“含标头”，则该选项为列索引（列 1、列 2 等）。

未命名范围

选择示例: [Excel]Sheet1!B3:F10

• “使用的范围”：所选范围内的所有行。
• 当前行选项：
  • 如果在“遍历 Excel 中的每一行”中选择了“含标头”，则该选项为所选内容的第 1 行内的值。
  • 如果未在“遍历 Excel 中的每一行”中选择“含标头”，则该选项为列索引（列 1、列 2 等）。

整列

选择示例: [Excel]Sheet1!B:F

• “使用的范围”：工作表中存在数据的选定列中的行，包括选定列以外的其他列中存在数据的行。
• 当前行选项：
  • 如果在“遍历 Excel 中的每一行”中选择了“含标头”，则该选项为列中第 1 行内的值。
  • 如果未在“遍历 Excel 中的每一行”中选择“含标头”，则该选项为列索引（列 1、列 2 等）。

整行

选择示例: [Excel]Sheet1!3:10

• “使用的范围”：所选行中存在数据的单元格。
• 当前行选项：
  • 如果在“遍历 Excel 中的每一行”中选择了“含标头”，则该选项为所选内容的第 1 行内的值。
  • 如果未在“遍历 Excel 中的每一行”中选择“含标头”，则该选项为列索引（列 1、列 2 等）。

单个单元格

选择示例: [Excel]Sheet1!B3

• “使用的范围”：活动将从所选单元格开始的范围视为左上角，只要工作表中存在数据，则活动会一直向右和向下扩展。例如，如果选择的是“Sheet1!B3”，并且 Sheet1 中包含至多达到“AC”列和“115”行的数据，则“遍历 Excel 中的每一行”中的活动将使用“B3:AC115”计算范围。

  如果所选单元格位于包含数据的最后一列的右侧或包含数据的最后一行下方，则系统将仅使用所选单元格中的数据。

• 当前行选项：

  • 如果在“遍历 Excel 中的每一行”中选择了“含标头”，则该选项为所选内容的第 1 行内的值。
  • 如果未在“遍历 Excel 中的每一行”中选择“含标头”，则该选项为列索引（列 1、列 2 等）。

注意：上述选择示例在 StudioX 中可能有所不同。这取决于您是设置属性的表达式还是查看表达式预览。