Skip to main content

迭代文件 (模型工具)

汇总

用于迭代文件夹中的文件。

了解“迭代文件”在 ModelBuilder 中的工作原理

用法

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

  • 文件类型参数可用于迭代具有特定扩展名的文件。 例如,如果只想迭代扩展名为 .log 的文件,请指定 log 作为 FileType 参数值。

  • 如果该文件在目录窗格中显示为数据集,则工具将跳过该文件。 最常见的示例是 shape 文件、.dbf 文件、栅格文件(.jpg.tif.img.png.bmp)、CAD 文件(.dxf.dwg)以及地图文件(.mxd.aprx)。

  • 该工具有两个输出:文件名称,这些输出可在其他工具中用作内联变量(例如,%Name%)。

  • 在可选扩展名参数中指定文件扩展名,例如 .txt.pdf.zip 等。 例如,如果工具迭代文本文件且在 ASCII 转栅格等工具中使用输出,请指定 txt

  • 大部分工具都支持来自此工具的输出文件格式,但复制等工具除外,该工具要求定义输出名称中的文件扩展名。 例如,如果要使用此工具迭代用作复制工具的输入的 .zip 文件,输出名称必须包含扩展名 Name.zip%Name%.zip

参数

标注 说明 数据类型

文件夹

输入文件所在的文件夹。

Folder

通配符

(可选)

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

String

文件类型

(可选)

文件扩展名,例如 txt、txt 等。 只会迭代具有扩展名的文件。 请勿在文件扩展名前使用句点。

String

递归

(可选)

指定是否将递归迭代主文件夹的所有子文件夹。

  • Checked—将递归迭代所有子文件夹。

  • Unchecked—将不会递归迭代所有子文件夹。

Boolean

派生输出

标注 说明 数据类型

文件

文件的完整路径。

File

名称

数据集的名称。

String

环境

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

许可信息

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