迭代字段 (ModelBuilder)

摘要

迭代表中的字段。

了解迭代字段在 ModelBuilder 中的工作原理

使用情况

• 此工具专用于 ModelBuilder ，而并不在编写 Python 脚本时使用。

• 数据类型和通配符参数可以用作过滤器来限制要迭代的字段。

• 如果未定义字段名称参数，则该工具将迭代支持过滤器的字段（如果指定）。

• 当该工具执行时，字段名称参数中的重复字段将被忽略。

• 该工具有两个输出：值和计数，其中计数可用作其他工具的行内变量（如 %Value%）。值输出为字段类型，可以与接受字段类型值的其他工具一起使用。计数输出为工具迭代的字段总数。

• 几何字段未在数据类型参数中列出，但可以使用字段名称参数进行访问。

• 如果字段未在字段名称参数中列出，值输出将使用表中的第一个字段。如果字段未在字段名称参数中列出，值输出将使用字段名称参数中的第一个字段。在这两种情况下，如果第一个字段是几何字段，则将跳过该字段。

• 在编辑模式下保存表格以更新字段名称参数中的字段。

• 该工具接受具有连接表的输入。连接表将生成支持维护全限定的字段名环境的字段名称。

• 此工具可接受来自数据库连接的输入。

• 发生以下任何一种情况时，将在字段名称参数旁边显示一条消息：

  • 字段在表格中不存在。
  • 字段与指定的数据类型过滤器不匹配。
  • 字段与指定的通配符过滤器不匹配。
  这些消息将作为警告显示在迭代字段工具对话框中，并显示为错误字段名称变量对话框上的错误。

参数

对话框

标注	说明	数据类型
输入表	具有要迭代字段的输入表。	Table View; Raster Layer; Mosaic Layer
字段类型 (可选)	指定用于过滤字段的字段类型。如果未指定字段类型，则将迭代受支持字段类型的所有字段。 Blob—BLOB 字段将被迭代。 日期—日期字段将被迭代。 双精度—双精度型字段将被迭代。 浮点型—浮点型字段将被迭代。 GUID—GUID 字段将被迭代。 长整型—长整型字段将被迭代。 栅格—栅格字段将被迭代。 短整型—短整型字段将被迭代。 文本型—文本字段将被迭代。	String
通配符 (可选)	限制将要迭代的字段。通配符可用于字段名称和字段别名，并且是 * 和其他字符的组合。例如，可使用此参数来限制对以某个字符或词语（例如 A* 或 Ari* 或 Land* 等）开头的输入字段名称或字段别名进行迭代。星号等同于搜索所有字段。如果未指定通配符，则将返回所有输入。	String
字段名称 (可选)	将要迭代的字段列表。	Field

派生输出

标注	说明	数据类型
值	每次迭代返回的字段。	字段
计数	所有迭代的字段总数。	长整型

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是