遍历循环

UiPath.Core.Activities.ForEach

描述

对集合的每个元素执行“正文”部分中指定一个或一系列活动。可以使用迭代器变量 item 在“正文”部分的活动中引用元素。

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台配置

• “输入” - 要遍历的项目集合。 此字段仅支持IEnumerable值。

正文

• 如果条件为真，则系统会执行放置在其中的活动。

显示其他属性

• “项目名称”- 引用当前迭代的名称。 使用描述项目的名称更容易识别。

  备注：

  In字段的值必须是同质对象的集合。

• 参数类型- 此为下拉列表，用于从中选择要与活动搭配使用的变量类型。

• “条件”- 如果条件为真，则系统会执行活动正文。
• “最大迭代次数”- 执行活动的最大次数。
• “索引”- 该索引从零开始，用于指定正在迭代的当前集合中的元素，其存储在“Int32”变量中。

Windows 配置

设计器面板

• “包含” - 指定要遍历的列表。

正文

• 如果条件为真，则系统会执行放置在其中的活动。

• 常见

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

• 其他

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

属性面板

• “项目名称”- 引用当前迭代的名称。 使用描述项目的名称更容易识别。

• 参数类型- 此为下拉列表，用于从中选择要与活动搭配使用的变量类型。

• “条件”- 如果条件为真，则系统会执行活动正文。
• “最大迭代次数”- 执行活动的最大次数。
• “索引”- 该索引从零开始，用于指定正在迭代的当前集合中的元素，其存储在“Int32”变量中。

Windows - 旧版配置

设计器面板

• “遍历循环”- 引用迭代中当前项目时所用的名称。使用描述项目的名称更容易识别。
• “包含”- 指定要遍历的列表。

正文

• 如果条件为真，则系统会执行放置在其中的活动。

属性面板

常见

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

输入

• “条件”- 如果条件为真，则系统会执行活动正文。
• “最大迭代次数”- 执行活动的最大次数。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
• “类型参数”- 此为下拉列表，用于从中选择要与活动搭配使用的变量类型。
• “项目列表”- 要进行值迭代的变量。此字段仅支持 IEnumerable 变量。
  备注：

  • 使用“输入”字段更改参数类型时，将删除此活动的内容。
  • “项目列表”字段的值必须是同质对象的集合。

输出

• “索引”- 该索引从零开始，用于指定正在迭代的当前集合中的元素，其存储在“Int32”变量中。

使用“遍历循环”活动的示例

在此示例中，我们使用由三个元素组成的简单 IEnumerable 变量，并在“消息框”中显示每个元素:

1. 创建一个新流程，并将一个“遍历循环”活动拖动到工作流设计器中。
2. 在“变量”面板中，使用以下值创建一个名为 List 的新 IEnumerable 变量：

   {"one", "two", "three"}

3. 在“遍历循环”活动的“值”属性中插入 List 变量。
4. 将“消息框”活动拖动至“遍历循环”活动的“正文”部分。
5. 将 item 迭代器变量插入“消息框”活动的“文本”属性字段。
6. 运行文件。“遍历循环”活动遍历 List 变量中指定的每个值，并将其显示在单独的消息框中。