迭代字段值 (ModelBuilder)

描述

迭代字段中的所有值。

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

使用方法

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

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

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

• 如果模型中已添加一个迭代器，模型中的所有工具都会对此迭代器中的每个值进行迭代。如果您不想对每个被迭代的值运行模型中的每个工具，请创建一个只包含迭代器的子模型/嵌套模型内的子模型/镶嵌模型，并将其作为模型工具添加到主模型中。

语法

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

参数	说明	数据类型
in_table	要进行迭代的输入表。	Table View
field	要进行迭代的输入字段。	Field
data_type （可选）	指定输出值的数据类型。默认数据类型为字符串，但根据输出将在模型中的使用方式，可指定不同的数据类型。例如，如果字段包含要素类的路径，则可将数据类型设置为“要素类”，并将输出变量用作接受要素类的工具的输入。 Address Locator —地址定位器 Address Locator Style —地址定位器样式 Analysis cell size —分析像元大小 Any value —任意值 ArcMap Document —ArcMap 文档 Areal unit —面积单位 Boolean —布尔型 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 —抽取 Disk Connection —磁盘连接 Double —双精度型 Encrypted String —加密字符串 Envelope —包络 Evaluation Scale —评估等级 Extent —范围 Extract Values —提取值 Facility Network —设施点网络 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 切片图层 LAS Dataset —LAS 数据集 LAS Dataset Layer —LAS 数据集图层 Layer —图层 Layer File —图层文件 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 Dataset —网络数据集 Network Dataset Layer —网络数据集图层 Parcel Fabric —宗地结构 Parcel Fabric 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 —重映射 Route Measure Event Properties —路线测量事件属性 Schematic Dataset —逻辑示意图数据集 Schematic Diagram —逻辑示意图 Schematic Diagram Class —逻辑示意图类 Schematic Folder —逻辑示意图文件夹 Schematic 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 —拓扑图层 Transformation function —变换函数 Variant —变量 Vertical factor —垂直系数 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: 是