复制要素 (数据管理)

摘要

将输入要素类或图层中的要素复制到新要素类。

使用情况

  • 如果输入为图层并具有选择内容,则只能将所选要素复制到输出要素类。

  • 输入要素的几何特征和属性特征都将被复制到输出要素类。

  • 此工具可用于进行数据转换,因为它可以读取多种要素格式(任何可添加到地图中的格式),并且可将这些要素格式写入 shapefile 或地理数据库中。

参数

标注说明数据类型
输入要素

要复制的要素。

Feature Layer
输出要素类

将创建的要素类以及将要素复制到的要素类。

Feature Class
配置关键字
(可选)

如果输出为地理数据库,则将应用地理数据库配置关键字。

String
输出空间格网 1
(可选)

已在 ArcGIS AllSource 中弃用此参数。 将忽略您输入的任何值。

Double
输出空间格网 2
(可选)

已在 ArcGIS AllSource 中弃用此参数。 将忽略您输入的任何值。

Double
输出空间格网 3
(可选)

已在 ArcGIS AllSource 中弃用此参数。 将忽略您输入的任何值。

Double

arcpy.management.CopyFeatures(in_features, out_feature_class, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})
名称说明数据类型
in_features

要复制的要素。

Feature Layer
out_feature_class

将创建的要素类以及将要素复制到的要素类。

Feature Class
config_keyword
(可选)

如果输出为地理数据库,则将应用地理数据库配置关键字。

String
spatial_grid_1
(可选)

已在 ArcGIS AllSource 中弃用此参数。 将忽略您输入的任何值。

Double
spatial_grid_2
(可选)

已在 ArcGIS AllSource 中弃用此参数。 将忽略您输入的任何值。

Double
spatial_grid_3
(可选)

已在 ArcGIS AllSource 中弃用此参数。 将忽略您输入的任何值。

Double

代码示例

CopyFeatures 示例(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 CopyFeatures 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("climate.shp", "C:/output/output.gdb/climate")
CopyFeatures 示例 2(独立脚本)

以下独立脚本演示了如何使用 CopyFeatures 函数将文件夹中的 shapefile 复制到文件地理数据库中。

# Name: CopyFeatures_Example2.py
# Description: Convert all shapefiles in a folder to geodatabase feature classes
 
# Import system modules
import arcpy
import os
 
# Set environment settings
arcpy.env.workspace = "C:/data"
 
# Set local variables
out_workspace = "c:/output/output.gdb"
 
# Use ListFeatureClasses to generate a list of shapefiles in the workspace 
# shown above.
fc_list = arcpy.ListFeatureClasses()
 
# Run CopyFeatures for each input shapefile
for shapefile in fc_list:
    # Determine the new output feature class path and name
    out_featureclass = os.path.join(out_workspace, 
                                    os.path.splitext(shapefile)[0])
    arcpy.management.CopyFeatures(shapefile, out_featureclass)