迭代字段 (ModelBuilder)

使用方法

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

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

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

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

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

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

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

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

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

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

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

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

语法

arcpy.mb.IterateFields(in_table, {field_type}, {wildcard}, {input_fields})
参数说明数据类型
in_table

具有要迭代字段的输入表。

Table View; Raster Layer; Mosaic Layer
field_type
[field_type,...]
(可选)

指定用于过滤字段的字段类型。如果未指定字段类型,则将迭代受支持字段类型的所有字段。

  • BLOBBLOB 字段将被迭代。
  • DATE日期字段将被迭代。
  • DOUBLE双精度型字段将被迭代。
  • FLOAT浮点型字段将被迭代。
  • GUIDGUID 字段将被迭代。
  • LONG长整型字段将被迭代。
  • RASTER栅格字段将被迭代。
  • SHORT短整型字段将被迭代。
  • TEXT文本字段将被迭代。
String
wildcard
(可选)

限制将要迭代的字段。通配符可用于字段名称和字段别名,并且是 * 和其他字符的组合。例如,可使用此参数来限制对以某个字符或词语(例如 A*Ari*Land* 等)开头的输入字段名称或字段别名进行迭代。星号等同于搜索所有字段。如果未指定通配符,则将返回所有输入。

String
input_fields
[input_fields,...]
(可选)

将要迭代的字段列表。

Field

派生输出

名称说明数据类型
output_field

每次迭代返回的字段。

字段
output_count

所有迭代的字段总数。

长整型

环境

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

许可信息

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