复制要素 (数据管理)

摘要

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

使用情况

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

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

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

参数

对话框

标注	说明	数据类型
输入要素	要复制的要素。	Feature Layer
输出要素类	将创建的要素类以及将要素复制到的要素类。	Feature Class
配置关键字 (可选)	如果输出为地理数据库，则将应用地理数据库配置关键字。	String
输出空间格网 1 (可选)	已在 ArcGIS Pro 中弃用此参数。 将忽略您输入的任何值。	Double
输出空间格网 2 (可选)	已在 ArcGIS Pro 中弃用此参数。 将忽略您输入的任何值。	Double
输出空间格网 3 (可选)	已在 ArcGIS Pro 中弃用此参数。 将忽略您输入的任何值。	Double

Python

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 Pro 中弃用此参数。 将忽略您输入的任何值。	Double
spatial_grid_2 (可选)	已在 ArcGIS Pro 中弃用此参数。 将忽略您输入的任何值。	Double
spatial_grid_3 (可选)	已在 ArcGIS Pro 中弃用此参数。 将忽略您输入的任何值。	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)

环境

当前工作空间, 临时工作空间, 输出坐标系, 地理变换, 范围, XY 分辨率, XY 容差, 输出包含 M 值, M 分辨率, M 容差, 输出包含 Z 值, 默认输出 Z 值, Z 分辨率, Z 容差, 限定的字段名, 输出配置关键字, 维护附件, 自动提交, 输出 XY 值域, 输出 M 值域, 输出 Z 值域, 保留全局 ID

许可信息

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