迭代字段值 (ModelBuilder)

描述

迭代字段中的所有值。

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

使用方法

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

• 此工具的输出是名为 Value 的变量，且包含字段值。此变量可用在行内变量替换 (%Value%) 中。

• 数据类型参数可指定输出变量的数据类型。默认数据类型为字符串，但根据输出将在模型中的使用方式，可指定其他数据类型。例如，如果字段包含要素类的路径，则可将数据类型参数设置为要素类，并将输出变量用作接受要素类的工具的输入。

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

语法

arcpy.mb.IterateFieldValues(in_table, field, {data_type}, {unique_values}, {skip_nulls}, {null_value})

参数	说明	数据类型
in_table	要进行迭代的输入表。	Table View; Raster Layer
field	要进行迭代的输入字段。	Field
data_type （可选）	指定输出值的数据类型。默认数据类型为字符串，但根据输出将在模型中的使用方式，可指定其他数据类型。例如，如果字段包含要素类的路径，则可将此参数设置为要素类，并将输出变量用作接受要素类的工具的输入。 Address Locator —地址定位器 Address Locator Style —地址定位器样式 Analysis Cell Size —分析像元大小 Annotation Layer —注记图层 Any Value —任意值 ArcMap Document —ArcMap 文档 Areal Unit —面积单位 BIM File Workspace —BIM 文件工作空间 Boolean —布尔型 Building Discipline Layer —建筑领域图层 Building Discipline Scene Layer —构建领域场景图层 Building Layer —建筑图层 Building Scene Layer —构建场景图层 CAD Drawing Dataset —CAD 工程图数据集 Calculator Expression —计算器表达式 Catalog Root —目录根 Cell Size —像元大小 Cell Size XY —像元大小 XY Composite Layer —复合图层 Compression —压缩 Coordinate System —坐标系 Coordinate Systems Folder —坐标系文件夹 Coverage —覆盖范围 Coverage Feature Class —Coverage 要素类 Data Element —数据元素 Data File —数据文件 Database Connections —数据库连接 Dataset —数据集 Date —日期 dBASE Table —dBASE 表 Decimate —抽取 Diagram Layer —逻辑示意图图层 Dimension Layer —尺寸图层 Disk Connection —磁盘连接 Double —双精度型 Elevation Surface Layer —高程表面图层 Encrypted String —加密字符串 Envelope —包络 Evaluation Scale —评估等级 Extent —范围 Extract Values —提取值 Feature Class —要素类 Feature Dataset —要素数据集 Feature Layer —要素图层 Feature Set —要素集 Field —字段 Field Info —字段信息 Field Mappings —字段映射 File —文件 Folder —文件夹 Formulated Raster —格式化栅格 Fuzzy function —模糊函数 GeoDataServer —GeoDataServer Geodataset —地理数据集 Geometric Network —几何网络 Geostatistical Layer —地统计图层 Geostatistical Search Neighborhood —地统计搜索邻域 Geostatistical Value Table —地统计值表 GlobeServer —GlobeServer GPServer —GPServer Graph —图形 Graph Data Table —图表数据表 Group Layer —图层组 Horizontal Factor —水平系数 Image Service —影像服务 Index —索引 INFO Expression —INFO 表达式 INFO Item —INFO 项目 INFO Table —INFO 表 Internet Tiled Layer —Internet 切片图层 KML Layer —KML 图层 LAS Dataset —LAS 数据集 LAS Dataset Layer —LAS 数据集图层 Layer —图层 Layer File —图层文件 Layout —布局 Line —线 Linear Unit —线性单位 Long —长整型 M Domain —M 值域 Map —地图 Map Server Layer —地图服务器图层 MapServer —MapServer Mosaic Dataset —镶嵌数据集 Mosaic Layer —镶嵌图层 Neighborhood —邻域 Network Analyst Class FieldMap —Network Analyst 类 FieldMap Network Analyst Hierarchy Settings —Network Analyst 等级设置 Network Analyst Layer —网络分析图层 Network Data Source —网络数据源 Network Dataset —网络数据集 Network Dataset Layer —网络数据集图层 Network Travel Mode —网络出行模式 Parcel Fabric —宗地结构 Parcel Fabric for ArcMap —ArcMap 宗地结构 Parcel Fabric Layer for ArcMap —ArcMap 宗地结构图层 Parcel Layer —宗地图层 Point —点 Polygon —面 Projection File —投影文件 Pyramid —金字塔 Radius —半径 Random Number Generator —随机数生成器 Raster Band —栅格波段 Raster Calculator Expression —栅格计算器表达式 Raster Catalog —栅格目录 Raster Catalog Layer —栅格目录图层 Raster Data Layer —栅格数据图层 Raster Dataset —栅格数据集 Raster Layer —栅格图层 Raster Statistics —栅格统计 Raster Type —栅格类型 Record Set —记录集 Relationship Class —关系类 Remap —重映射 Report —报告 Route Measure Event Properties —路线测量事件属性 Scene Layer —场景图层 Semivariogram —半变异函数 ServerConnection —ServerConnection Shapefile —Shapefile Spatial Reference —空间参考 SQL Expression —SQL 表达式 String —字符串 String Hidden —隐藏字符串 Table —表 Table View —表视图 Terrain Layer —地形图层 Text File —文本文件 Tile Size —分块大小 Time configuration —时间配置 Time Unit —时间单位 TIN —TIN TIN Layer —TIN 图层 Tool —工具 Toolbox —工具箱 Topo Features —拓扑要素 Topology —拓扑 Topology Layer —拓扑图层 Trace Network —追踪网络 Trace Network Layer —追踪网络图层 Transformation function —变换函数 Utility Network —公共设施网络 Utility Network Layer —公共设施网络图层 Variant —变量 Vector Tile Layer —矢量切片图层 Vertical Factor —垂直系数 Voxel Layer —体素图层 VPF Coverage —VPF Coverage VPF Table —VPF 表 WCS Coverage —WCS Coverage Weighted Overlay Table —加权叠加表 Weighted Sum —加权总和 WMS Map —WMS 地图 Workspace —工作空间 XY Domain —XY 值域 Z Domain —Z 值域	String
unique_values （可选）	指定迭代值是否基于唯一值。 选中 - 迭代值将基于指定字段的唯一值。 未选中 - 将针对输入表中的每条记录运行迭代。	Boolean
skip_nulls （可选）	指定是否会跳过字段中的空值。 选中 - 选择过程中将跳过字段中的空值。 未选中 - 选择过程中不会跳过字段中的空值。	Boolean
null_value （可选）	要跳过的空值，例如 -9999、Null 或 -1。对于字符串，默认值为 ""；对于数字，默认值为“0”。	String

派生输出

名称	说明	数据类型
value	每次迭代返回的字段值。	任意值

环境

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

许可信息

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