批处理脚本的首要任务之一是为可用数据编写目录，以便在处理过程中可以遍历数据。ArcPy 具有多个专为创建此类列表而构建的函数，包括 ListDatasets、ListFeatureClasses、ListFiles、ListRasters、ListTables 和 ListWorkspaces。

ArcPy数据列表遍历

批处理脚本的首要任务之一是为可用数据编写目录，以便在处理过程中可以遍历数据。

ArcPy 具有多个专为创建此类列表而构建的函数。

函数	说明
ListFields(dataset, wild_card, field_type)	返回在输入值中找到的字段的列表
ListIndexes(dataset, wild_card)	返回在输入值中找到的属性索引的列表
ListDatasets(wild_card, feature_type)	返回当前工作空间中的数据集
ListFeatureClasses(wild_card, feature_type, feature_dataset)	返回当前工作空间中的要素类
ListFiles(wild_card)	返回当前工作空间中的文件
ListRasters(wild_card, raster_type)	返回在当前工作空间中找到的栅格数据的列表
ListTables(wild_card, table_type)	返回在当前工作空间中找到的表的列表
ListWorkspaces(wild_card, workspace_type)	返回在当前工作空间中找到的工作空间的列表
ListVersions(sde_workspace)	返回已连接用户有权使用的版本的列表

注意：必须先设置工作空间环境，然后才能使用多个列表函数，包括 ListDatasets、ListFeatureClasses、ListFiles、ListRasters、ListTables 和 ListWorkspaces。

1、ListFields(dataset, wild_card, field_type)

可返回指定数据集中的要素类、shapefile 或表中的字段的列表。返回的列表可用针对名称和字段类型的搜索条件进行限制，并将包含字段对象。

参数说明

• ​

  ​dataset​

  ​ 带有要返回的字段的指定要素类或表。
• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。(默认值为 None)

• ​

  ​field_type​

  ​ 要返回的指定字段类型。以下是可用的字段类型：

• All — 返回所有字段类型。这是默认设置。
• BLOB —仅返回 BLOB 字段类型。
• Date —仅返回日期字段类型。
• Double —仅返回双精度字段类型。
• Geometry —仅返回几何字段类型。
• GlobalID —仅返回 GlobalID 字段类型。
• GUID —仅返回 GUID 字段类型。
• Integer —仅返回整型字段类型。
• OID —仅返回 OID 字段类型。
• Raster —仅返回栅格字段类型。
• Single —仅返回单精度字段类型。
• SmallInteger —仅返回短整型字段类型。

• String —仅返回字符串字段类型。

  (默认值为 All)

2、ListIndexes(dataset, wild_card)

可返回指定数据集中的要素类、shapefile 或表中的索引的列表。

参数说明

• ​

  ​dataset​

  ​ 带有要返回的索引的指定要素类或表。
• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

3、ListDatasets(wild_card, feature_type)

返回当前工作空间中的数据集的列表。可针对数据集名称和数据集类型指定搜索条件，从而限制返回的列表。

参数说明

• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

• ​

  ​feature_type​

  ​ 限制由 wild_card 参数返回的结果的数据集类型。以下是可用的数据集类型：

• Coverage —仅 coverage。
• Feature —coverage 或地理数据库数据集（取决于工作空间）。
• GeometricNetwork —仅几何网络数据集。
• Mosaic —仅镶嵌数据集。
• Network —仅网络数据集。
• ParcelFabric —仅宗地结构数据集。
• Raster —仅栅格数据集。
• RasterCatalog —仅栅格目录数据集。
• Schematic —仅逻辑示意图数据集。
• Terrain —仅 terrain 数据集。
• Tin —仅 TIN 数据集。
• Topology —仅拓扑数据集。

• All —工作空间中的所有数据集。这是默认值。

  (默认值为 All)

4、ListFeatureClasses(wild_card, feature_type, feature_dataset)

可返回当前工作空间中受名称、要素类型和可选要素数据集限制的要素类的列表。

参数说明

• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

• ​

  ​feature_type​

  ​ 将限制结果的要素类型。下表中列出了一些有效要素类型：

• Annotation —注记要素类
• Arc —弧（或折线）要素类
• Dimension —尺寸要素类
• Edge —边要素类
• Junction —交汇点要素类
• Label — 标注要素类
• Line —折线（或弧）要素类
• Multipatch —多面体要素类
• Multipoint —多点要素类
• Node —节点要素类
• Point —点要素类
• Polygon —面要素类
• Polyline —折线（或弧）要素类
• Region —区域要素类
• Route —路径要素类
• Tic —控制点要素类

• All — 工作空间中的所有要素类。这是默认设置。

  (默认值为 All)

• ​

  ​feature_dataset​

  ​ 若已指定，则限制返回到要素数据集的要素类。若留空，则在工作空间中将仅返回独立要素类。

5、ListFiles(wild_card)

返回当前工作空间中的文件列表。

参数说明

• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

6、ListRasters(wild_card, raster_type)

返回当前工作空间中的栅格列表。

参数说明

• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

• ​

  ​raster_type​

  ​ 将限制结果的栅格类型。以下是可用的栅格类型：

• BMP —位图图形栅格数据集格式。
• GIF —栅格数据集的图形交换格式。
• IMG — ERDAS IMAGINE 栅格数据格式
• JP2 —JPEG 2000 栅格数据集格式。
• JPG —联合图像专家组栅格数据集格式。
• PNG — 可移植网络图形栅格数据集格式。
• TIF —栅格数据集的标记图像文件。
• GRID — 格网数据格式。

• All —返回所有支持的栅格类型。这是默认设置。

  (默认值为 All)

7、ListTables(wild_card, table_type)

返回当前工作空间中的表格列表。

参数说明

• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

• ​

  ​table_type​

  ​ 用于限制结果的表类型。以下是有效的表类型：

• dBASE —仅返回 dBASE 类型的表。
• INFO —仅返回独立 INFO 表。

• ALL —返回所有独立表（包括地理数据库表）。这是默认设置。

  (默认值为 All)

8、ListWorkspaces(wild_card, workspace_type)

返回当前工作空间中的工作空间列表。

参数说明

• ​

  ​wild_card​

  ​ 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。

• * 表示零个或多个字符。

• ​

  ​workspace_type​

  ​ 将限制所返回结果的工作空间类型。以下是可用的工作空间类型：

• Access —将仅选择个人地理数据库。
• Coverage —将仅选择 coverage 工作空间。
• FileGDB —将仅选择文件地理数据库。
• Folder —将仅选择 shapefile 工作空间。
• SDE —将仅选择企业级数据库。

• All —将选择所有工作空间。这是默认设置。

  (默认值为 All)

9、ListVersions(sde_workspace)

列出连接用户有权使用的版本

参数说明

• ​

  ​sde_workspace​

  ​ 企业级地理数据库工作空间。