ArcPy数据列表遍历

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。

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)

ListIndexes(dataset, wild_card)

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

参数说明

+dataset 带有要返回的索引的指定要素类或表。

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

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

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)

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 若已指定，则限制返回到要素数据集的要素类。若留空，则在工作空间中将仅返回独立要素类。

ListFiles(wild_card)

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

参数说明

• wild_card 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。
  • * 表示零个或多个字符。

ListRasters(wild_card, raster_type)

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

参数说明

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

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

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

  • BMP —位图图形栅格数据集格式。
  • GIF —栅格数据集的图形交换格式。
  • IMG — ERDAS IMAGINE 栅格数据格式
  • JP2 —JPEG 2000 栅格数据集格式。
  • JPG —联合图像专家组栅格数据集格式。
  • PNG — 可移植网络图形栅格数据集格式。
  • TIF —栅格数据集的标记图像文件。
  • GRID — 格网数据格式。
  • All —返回所有支持的栅格类型。这是默认设置。
    
    (默认值为 All)

ListTables(wild_card, table_type)

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

参数说明

• wild_card 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。
  • * 表示零个或多个字符。
• table_type 用于限制结果的表类型。以下是有效的表类型：
  • dBASE —仅返回 dBASE 类型的表。
  • INFO —仅返回独立 INFO 表。
  • ALL —返回所有独立表（包括地理数据库表）。这是默认设置。
    
    (默认值为 All)

ListWorkspaces(wild_card, workspace_type)

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

参数说明

• wild_card 限制返回的结果。如果未指定某一值，则返回所有值。通配符不区分大小写。
  • * 表示零个或多个字符。
• workspace_type 将限制所返回结果的工作空间类型。以下是可用的工作空间类型：
  • Access —将仅选择个人地理数据库。
  • Coverage —将仅选择 coverage 工作空间。
  • FileGDB —将仅选择文件地理数据库。
  • Folder —将仅选择 shapefile 工作空间。
  • SDE —将仅选择企业级数据库。
  • All —将选择所有工作空间。这是默认设置。
    
    (默认值为 All)

ListVersions(sde_workspace)

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

参数说明

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