ListDatasets

Résumé

Returns a list of datasets in the current workspace. Search conditions can be specified for the dataset name and dataset type to limit the list that is returned.

Discussion

The workspace environment must be set before using several of the list functions, including ListDatasets, ListFeatureClasses, ListFiles, ListRasters, ListTables, and ListWorkspaces.

Syntaxe

ListDatasets ({wild_card}, {feature_type})
ParamètreExplicationType de données
wild_card

Limits the results returned. If a value is not specified, all values are returned. The wildcard is not case sensitive.

SymbolDescriptionExample

*

Represents zero or more characters.

Te* finds Tennessee and Texas.

String
feature_type

The dataset type that will limit the results returned by the wild_card argument. The following are valid dataset types:

  • CoverageOnly coverages.
  • FeatureCoverage or geodatabase dataset, depending on the workspace.
  • GeometricNetworkOnly geometric network datasets.
  • MosaicOnly mosaic datasets.
  • NetworkOnly network datasets.
  • ParcelFabricOnly parcel fabric datasets.
  • RasterOnly raster datasets.
  • RasterCatalogOnly raster catalog datasets.
  • SchematicOnly schematic datasets.
  • TerrainOnly terrain datasets.
  • TinOnly TIN datasets.
  • TopologyOnly topology datasets.
  • AllAll datasets in the workspace. This is the default value.

(La valeur par défaut est All)

String
Valeur renvoyée
Type de donnéesExplication
String

A list containing dataset names returned from the function, limited by the wildcard and feature type arguments.

Exemple de code

ListDatasets example

List feature dataset names that start with C.

import arcpy

arcpy.env.workspace = "c:/data"

# Print to the Interactive window all the feature datasets in the
#   workspace that start with the letter C.
datasets = arcpy.ListDatasets("C*", "Feature")

for dataset in datasets:
    print(dataset)
ListDatasets example 2

List feature dataset names that start with c or f, start with letters except c, or contain both c and f.

import arcpy
arcpy.env.workspace = 'c:/data'

# Print to the interactive window all the feature datasets in the
#   workspaces that start with the letter c or f.
datasets1 = list(set(arcpy.ListDatasets("c*", "Feature")) |
                 set(arcpy.ListDatasets("f*", "Feature")))
print(datasets1)

#   workspaces that start with the letters except c
datasets2 = list(set(arcpy.ListDatasets("*", "Feature")) -
                 set(arcpy.ListDatasets("c*", "Feature")))
print(datasets2)

#   workspaces that contain both the letter c and f
datasets3 = list(set(arcpy.ListDatasets("*c*", "Feature")) &
                 set(arcpy.ListDatasets("*f*", "Feature")))
print(datasets3)

Rubriques connexes