迭代图层 (模型工具)

汇总

迭代地图中的图层。

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

用法

• 此工具仅在 ModelBuilder 中提供，以供在模型中使用。 地理处理窗格或 Python 中不提供该工具。

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

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

  • 输出图层—基于已设置的参数过滤器的地图中的图层。 此图层将包含已在图层上设置的一切选择或连接。

  • 名称—图层的名称。 该名称可用于行内变量替换。

  • 输出图层类型—图层的类型。 该值与使用图层类型参数设置的图层类型相匹配。 输出值为常量且未本地化。 如果使用了两个或多个图层类型，则该类型可用于创建分支模型，如下图所示：

    

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

    

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

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

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

参数

• Dialog

标注	说明	数据类型
输入地图	将要迭代的图层的输入地图。	Map
通配符 （可选）	* 与有助于限制结果的字符的组合。 星号相当于指定全部。 如果未指定通配符，将返回所有输入。 可以使用此参数来限制对以某个字符或词语（例如 A*、Ari* 或 Land* 等）开头的输入名称进行迭代。	String
图层类型 （可选）	指定将用于筛选要迭代图层的图层类型。 如果未指定图层类型，则将迭代所有受支持的图层类型。 可以使用多种图层类型来过滤图层。 3D 切片图层—将对 3D 切片图层进行迭代。 注记图层—注记图层将被迭代。 建筑图层—建筑物图层将被迭代。 建筑场景图层—建筑物场景图层将被迭代。 尺寸图层—尺寸图层将被迭代。 要素图层—要素图层将被迭代。 地统计分析图层—地统计图层将被迭代。 图层组—图层组将被迭代。 KML 图层—KML 图层将被迭代。 知识图谱图层—知识图谱图层将被迭代。 LAS 数据集图层—LAS 数据集图层将被迭代。 镶嵌图层—镶嵌图层将被迭代。 网络分析图层—网络分析图层将被迭代。 网络数据集图层—网络数据集图层将被迭代。 定向影像图层—定向影像图层将被迭代。 宗地图层—宗地图层将被迭代。 栅格图层—栅格图层将被迭代。 场景服务图层—场景服务图层将被迭代。 子类型图层组—子类型图层组将被迭代。 子类型表组—子类型表组将被迭代。 表视图—表视图将被迭代。 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
递归 （可选）	指定是否迭代嵌套图层组。 Checked—将迭代嵌套图层组。 Unchecked—将不会迭代嵌套图层组。	Boolean

派生输出

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

环境

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

许可信息

• 基本: 是
• 标准: 是
• 高级: 是

相关主题

• ModelBuilder 工具概览
• 在 ModelBuilder 中使用迭代器的示例