迭代字段 (模型构建器)

摘要

迭代表中的字段。

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

使用情况

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

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

• 如果未定义字段名称参数，则工具将迭代符合指定过滤器的字段。

• 字段名称参数中的重复字段将被忽略。

• 该工具有两个输出：值和计数，这些输出可在其他工具中用作内联变量（例如，%Value%）。 值输出是字段类型，可与接受字段类型值的其他工具配合使用。 计数输出是工具迭代的字段总数。

• 几何字段不会显示在数据类型参数中，但可以使用字段名称参数访问它们。

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

• 将表保存为编辑模式，以更新字段名称参数中的字段。

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

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

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

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

参数

对话框

标注	说明	数据类型
输入表	包含要返回的字段的输入表。	Table View; Raster Layer; Mosaic Layer
字段类型 (可选)	指定将用于过滤字段的字段类型。 如果未指定字段类型，则将返回所有支持的字段类型的字段。 大整数—将返回大整型字段。 Blob—将返回 BLOB 字段。 日期—将返回日期字段。 仅日期—将返回仅日期字段。 双精度—将返回双精度型字段。 浮点型—将返回浮点型字段。 GlobalID—将返回 GlobalID 字段。 GUID—将返回 GUID 字段。 长整型—将返回长整型字段。 栅格—将返回栅格字段。 短整型—将返回短整型字段。 文本—将返回文本字段。 仅时间—将返回仅时间字段。 时间戳偏移—将返回时间戳偏移字段。 XML—将返回 XML 字段。	String
通配符 (可选)	限制将返回的字段。 通配符是 * 和其他字符的组合，可用于字段名称和字段别名。 例如，该参数可用于限制以特定字符或单词（例如，A*、 Ari* 或 Land* 等）开头的输入字段名称或字段别名的迭代。 星号等同于搜索所有字段。 如果未指定通配符，将返回所有输入。	String
字段名称 (可选)	将返回字段的列表。	Field

派生输出

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

环境

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

许可信息

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