迭代图层 (ModelBuilder)

摘要

迭代地图中的图层。

了解“迭代图层”在 ModelBuilder 中的工作原理

使用情况

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

• 当图层类型参数设置为表视图时，仅迭代独立表。 要使用要素表或栅格表，将图层类型参数分别设置为要素图层或栅格图层。

• 对于每次迭代，该工具将返回以下输出：

  • 输出图层 - 基于已设置的参数过滤器的地图图层。 该图层将包含已在该图层上设置的所有选择或连接。
  • 名称 - 图层的名称。 此名称可在行内变量替换中使用。
  • 输出图层类型 - 图层的类型。 该值与使用图层类型参数设置的图层类型一致。 输出值为常量且未本地化。 如果使用两个或多个图层类型，则该类型可用于分支化模型，如下所示：

    

  • 工作空间或格式类型 - 图层的工作空间类型。 仅为要素图层、栅格图层和表视图返回此值。 输出值为常量且未本地化。 对于存储在基于文件夹的工作空间中的栅格图层，将返回文件格式（例如 TIFF），可使用该值分支化模型或作为诊断来评估迭代的图层类型。

    

• 该工具将返回的图层与使用图层类型参数设置的类型以及使用可见性和状态参数设置的过滤器匹配。 例如，如果图层类型参数设置为要素图层和栅格图层，可见性参数设置为不可见并且状态参数设置为有效，该工具将返回不可见且有效的要素图层和栅格图层。

• 如果未设置图层类型参数或没有图层与参数条件相匹配，则输出图层的值将设置为 OUTPUT_LAYER，名称和输出图层类型输出的值将设置为 FEATURE_LAYER，且工作空间或格式类型输出将设置为 WORKSPACE。

• 图层类型参数可以设置为多种类型，例如要素图层、栅格图层和表视图。 但是，该工具可以连接到可能与某些图层类型不兼容的下游工具，例如复制要素、复制栅格或复制行。 在此情况下，要支持多种图层类型，必须将图层类型参数设置为单个特定的图层类型。 然后，将输出连接到使用该特定数据类型的对应工具。 建立所有下游连接后，可将图层类型参数设置为所有三个图层类型。 此工作流是必需的，因为该工具的初始默认值设置为与将栅格视为输入的工具不兼容的要素图层类型。 一旦将所有图层类型都添加到模型中，验证就会使工具处于有效状态。

参数

对话框

标注	说明	数据类型
输入地图	包含要迭代的图层的输入地图。	Map
通配符 (可选)	* 与有助于限制结果的字符的组合。 星号相当于指定全部。 如果未指定通配符，将返回所有输入。 例如，可将其用于将输入名称迭代限制为从某一字符或词语开始（例如，A*、Ari* 或 Land* 等）。	String
图层类型 (可选)	指定将用于过滤图层的图层类型。 如果未指定图层类型，则将迭代所有受支持的图层类型。 可以使用多种图层类型来过滤图层。 注记图层—将迭代注记图层。 建筑图层—将迭代建筑物图层。 构建场景图层—将迭代建筑物场景图层。 尺寸图层—将迭代尺寸注记图层。 要素图层—将迭代要素图层。 地统计分析图层—将迭代地统计图层。 分组图层—将迭代图层组。 子类型图层组—将迭代子类型图层组。 KML 图层—将迭代 KML 图层。 LAS 数据集图层—将迭代 LAS 数据集图层。 镶嵌图层—将迭代镶嵌图层。 网络分析图层—将迭代 Network Analyst 图层。 网络数据集图层—将迭代网络数据集图层。 宗地图层—将迭代宗地图层。 栅格图层—将迭代栅格图层。 场景服务图层—将迭代场景服务图层。 表视图—将迭代表视图。 Terrain 图层—将迭代地形图层。 TIN 图层—将迭代 TIN 图层。 拓扑图层—将迭代拓扑图层。 追踪网络图层—将迭代追踪网络图层。 公共设施网络图层—将迭代公共设施网络图层。 体素图层—将迭代体素图层。	String
工作空间类型	指定将用于过滤图层的工作空间类型。 如果未指定工作空间类型，则将迭代受支持的工作空间类型的所有字段。 仅当图层类型参数设置为要素图层、栅格图层或表视图时，才启用工作空间类型参数。 多文件要素连接—多文件要素连接工作空间中的图层将被迭代。 BIM 文件—将迭代 BIM 文件工作空间中的图层。 CAD—将迭代 CAD 工作空间中的图层。 分隔文本文件—将迭代分隔文本文件工作空间中的图层。 企业级地理数据库—将迭代企业级地理数据库工作空间中的图层。 要素服务—将迭代要素服务工作空间中的图层。 文件地理数据库—将迭代文件地理数据库工作空间中的图层。 内存数据库—将迭代内存数据库工作空间中的图层。 Microsoft Excel—将迭代 Microsoft Excel 工作空间中的图层。 NetCDF—将迭代 NetCDF 工作空间中的图层。 OLE DB—将迭代 OLE DB 工作空间中的图层。 栅格—将迭代栅格工作空间中的图层。 Shapefile—将迭代 Shapefile 工作空间中的图层。 SQLite—将迭代 SQLite 工作空间中的图层。 SQL 查询图层—将迭代 SQL 查询图层工作空间中的图层。 流服务—将迭代流服务工作空间中的图层。 Web 要素服务—将迭代 Web 要素服务工作空间中的图层。	String
要素类型 (可选)	指定将用于过滤图层的要素类型。 如果未指定要素类型，则将迭代所有受支持的要素类型。 注记—将迭代注记要素类。 尺寸注记—将迭代尺寸注记要素类。 简单边—将迭代简单边要素类。 复杂边—将迭代复杂边要素类。 简单交汇点—将迭代简单交汇点要素类。 复杂交汇点—将迭代复杂交汇点要素类。 线—将迭代线要素类。 点—将迭代点要素类。 面—将迭代面要素类。 多面体—将迭代多面体要素类。	String
栅格类型 (可选)	当工作空间类型参数设置为栅格时将用于过滤栅格图层的栅格格式类型。 如果未指定栅格类型，则将迭代受支持栅格类型的所有图层。	String
可见性 (可选)	指定是否将使用图层可见性来过滤图层。 全部—图层可见性将不会用于过滤图层。 可见—可见图层将被迭代。 不可见—不可见图层将被迭代。	String
单个省/自治区/直辖市 (可选)	指定将用于过滤图层的图层状态。 如果该参数设置为无效，则将返回源路径图层损坏的图层。 全部—图层状态将不会用于过滤图层。 有效—将迭代有效图层。 无效—将迭代无效图层。	String
递归 (可选)	指定迭代器是否将迭代嵌套的图层组。 选中 - 将迭代嵌套的图层组。 未选中 - 不会迭代嵌套的图层组。	Boolean

派生输出

标注	说明	数据类型
输出图层	基于已设置的参数过滤器的地图图层。 该图层将包含已在该图层上设置的所有选择或连接。	Any Value
名称	图层的名称。	String
输出图层类型	图层的类型。	String
工作空间或格式类型	图层的工作空间类型。	String

环境

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

许可信息

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