Skip to main content

迭代要素选择 (模型工具)

汇总

迭代要素类中的要素。

了解迭代要素选择在 ModelBuilder 中的工作原理

用法

  • 此工具仅在 ModelBuilder 中提供，以供在模型中使用。 地理处理窗格或 Python 中不提供该工具。

  • 此工具不支持复杂要素类（如注记和尺寸注记）。

  • 多个按字段划分的组可用于选择。 如果指定一个或多个按字段划分的组，迭代次数由按字段划分的组的唯一组合数确定。 对于每次迭代，输出要素图层的选择由与按字段划分的组的给定组合相匹配的记录数来确定。 如果指定了多个分组依据字段，则会在输出行内变量名称中将这些字段值串连为 <field value1>_<field value2> 。 在下面的示例中，使用了两个分组字段：飓风的名称（名称）和飓风的类别（类别）。 输出值为 Katrina_H5，其他值则依此类推。

    “迭代要素选择”工具参数

  • 如果未指定按字段划分的组，则输出值将按“对象 ID”字段进行分组，且一次只能选择一个记录。 如果表没有“对象 ID”字段（例如 Excel 表），则输出值为空。

  • 该工具包含两种输出：所选要素及所选要素字段的分组值，它们可在其他工具中用作行内变量。

  • 可使用保存至图层文件工具将临时要素图层保存为图层文件或使用复制要素工具将此图层保存为新要素类。

  • 如果模型中添加了一个迭代器，那么模型中的所有工具会对迭代器中的每个值进行迭代。 如果您不想对每个被迭代的值运行模型中的每个工具，请创建一个只包含迭代器的子模型、模型内的模型或嵌套模型，并将其作为模型工具添加到主模型中。

参数

标注 说明 数据类型

使用要素

包含将迭代的要素的输入要素类或图层。

Feature Layer

分组依据字段

（可选）

将用于对可供选择的要素进行分组的一个或多个输入字段。 可定义多个输入字段，以根据字段的唯一组合进行选择。 如果未指定字段，则将使用“对象 ID”迭代要素。

值表列：

  • Field—The fields that will be used to group the features for selection.

  • Null Value—The value from the field that will be substituted for a null value.

Value Table

跳过空值

（可选）

指定是否将在选择过程中跳过一个或多个分组字段中的空值。

  • Checked—将在选择过程中跳过分组字段中的空值。

  • Unchecked—选择过程中不会跳过分组字段中的空值。 这是默认设置。

Boolean

派生输出

标注 说明 数据类型

所选要素

要素图层可在其他地理处理工具中使用，而这些工具可在 ModelBuilder 中接受要素图层。

Feature Layer

值

每次迭代返回的字段值。 如果指定了多个按字段划分的组，则会在输出行内变量名称中将这些字段值串连为 <field value1>_<field value2>。

Variant

环境

当前工作空间

许可信息

  • 基本: 是
  • 标准: 是
  • 高级: 是