迭代文件 (ModelBuilder)

使用方法

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

  • 文件扩展名选项可用于迭代具有特定扩展名的文件。例如,如果只想迭代扩展名为 .log 的文件,则将文件扩展名参数设置为 log

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

  • 此工具有两个输出:输出文件名称,其中名称可用作其他工具的行内变量(如 %Name%)。

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

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

语法

IterateFiles(in_folder, {wildcard}, {extension}, {recursive})
参数说明数据类型
in_folder

输入文件所位于的文件夹。

Folder
wildcard
(可选)

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

String
extension
(可选)

文件扩展名,例如 TXT、ZIP 等。只会迭代具有扩展名的文件。不要在文件扩展名前使用句点。

String
recursive
(可选)

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

  • 选中 - 将递归迭代所有子文件夹。
  • 未选中 - 将不会递归迭代所有子文件。
Boolean

派生输出

名称说明数据类型
file

文件的完整路径。

文件
name

数据集的名称。

字符串

环境

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

许可信息

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