迭代图层 (ModelBuilder)

使用情况

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

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

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

    • 输出图层 - 基于已设置的参数过滤器的地图图层。 该图层将包含已在该图层上设置的所有选择或连接。
    • 名称 - 图层的名称。 此名称可在行内变量替换中使用。
    • 输出图层类型 - 图层的类型。 该值与使用图层类型参数设置的图层类型一致。 输出值为常量且未本地化。 如果使用两个或多个图层类型,则该类型可用于分支化模型,如下所示:
      使用图层类型派生的输出的示例
    • 工作空间或格式类型 - 图层的工作空间类型。 仅为要素图层、栅格图层和表视图返回此值。 输出值为常量且未本地化。 对于存储在基于文件夹的工作空间中的栅格图层,将返回文件格式(例如 TIFF),可使用该值分支化模型或作为诊断来评估迭代的图层类型。
      使用工作空间类型派生的输出的示例

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

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

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

参数

标注说明数据类型
输入地图

包含要迭代的图层的输入地图。

Map
通配符
(可选)

* 与有助于限制结果的字符的组合。 星号相当于指定全部。 如果未指定通配符,则将返回所有输入。 可以使用此参数来限制对以某个字符或词语(例如 A*Ari*Land* 等)开头的输入名称进行迭代。

String
图层类型
(可选)

指定将用于过滤图层的图层类型。 如果未指定图层类型,则将迭代所有受支持的图层类型。 可以使用多种图层类型来过滤图层。

  • 3D 对象要素图层
  • 3D 切片图层将对 3D 切片图层进行迭代。
  • 注记图层将迭代注记图层。
  • 建筑图层将迭代建筑物图层。
  • 构建场景图层将迭代建筑物场景图层。
  • 尺寸图层将迭代尺寸注记图层。
  • 要素图层将迭代要素图层。
  • 地统计分析图层将迭代地统计图层。
  • 分组图层将迭代图层组。
  • 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: 是

相关主题