使用方法
此工具专用于 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,...] (可选) | 指定用于过滤字段的字段类型。如果未指定字段类型,则将迭代受支持字段类型的所有字段。
| String |
wildcard (可选) | 限制将要迭代的字段。通配符可用于字段名称和字段别名,并且是 * 和其他字符的组合。例如,可使用此参数来限制对以某个字符或词语(例如 A* 或 Ari* 或 Land* 等)开头的输入字段名称或字段别名进行迭代。星号等同于搜索所有字段。如果未指定通配符,则将返回所有输入。 | String |
input_fields [input_fields,...] (可选) | 将要迭代的字段列表。 | Field |
派生输出
名称 | 说明 | 数据类型 |
output_field | 每次迭代返回的字段。 | 字段 |
output_count | 所有迭代的字段总数。 | 长整型 |
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是