标注 | 说明 | 数据类型 |
输入要素 | 将导出到新要素类的输入要素。 | Feature Layer |
输出要素类 | 包含导出要素的输出要素类。 | Feature Class |
表达式 (可选) | 用于选择要素子集的 SQL 表达式。 | SQL Expression |
使用字段别名作为名称 (可选) | 指定是将输入字段名称还是字段别名用作输出字段名称。
| Boolean |
字段映射 (可选) | 将字段及其各自属性和源字段传输到输出数据集中。 默认情况下,输出包括来自输入数据集的所有字段。 使用字段映射来添加、删除、重命名和重新排序字段,以及更改其他字段属性。 字段映射还可以用于将两个或多个输入字段的值合并为单个输出字段。 | Field Mappings |
排序字段 (可选) | 包含对输入记录重新排序所用的值的一个或多个字段,以及记录的排序方向。
| Value Table |
摘要
用于将要素类或要素图层转换为新要素类。
使用情况
使用字段映射参数管理输出数据集中的字段及其内容。
- 您可以向字段列表中添加和移除字段,重新排序字段列表,并重命名字段。
- 输出字段的默认数据类型与它遇到的第一个输入字段(具有相同名称的字段)的数据类型相同。 可以将数据类型更改为其他有效的数据类型。
- 使用操作确定如何将一个或多个输入字段的值合并到单个输出字段中。 可用的操作包括第一个、最后一个、串连、求和、平均值、中位数、众数、最小值、最大值、标准差和计数。
- 当使用串连操作时,可以指定分隔符,例如逗号或其他字符。 单击分隔符文本框的开始部分以添加分隔符。
- 单个输入值不支持标准差选项。
- 对于文本源字段,使用分割文本按钮,可以选择从输入值中提取到输出字段的字符。 要访问分割文本按钮,需将鼠标悬停在输入字段列表中的文本字段上,然后指定起始和结束字符位置。
- 还可以使用 Python 脚本映射字段。
可用于选择要素子集的 SQL 表达式。 有关表达式参数语法的详细信息,请参阅 ArcGIS 中使用的查询表达式的 SQL 参考。
通过指定排序字段参数值,可以按升序或降序对行重新排序。 如果指定了多个字段,则行将按第一个字段排序,然后在该顺序内按第二个字段排序,依此类推。
转换包含子类型或域的地理数据库数据且输出工作空间不是地理数据库时,子类型和域代码以及描述都将包含在输出中。 使用传送字段属性域描述环境控制此行为。 默认情况下,只有属性域和子类型代码才会被包含在输出中,描述不会被包含在输出中。
注:
转换为包含子类型和域描述的 shapefile 比转换为不包含描述的 shapefile 可能需要更多时间(降低性能)。 如果输出中不需要子类型和属性域描述,请取消选中“传输字段属性域描述”环境以获得最佳性能。
参数
arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
名称 | 说明 | 数据类型 |
in_features | 将导出到新要素类的输入要素。 | Feature Layer |
out_features | 包含导出要素的输出要素类。 | Feature Class |
where_clause (可选) | 用于选择要素子集的 SQL 表达式。有关 SQL 语法的详细信息,请参阅帮助主题在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
use_field_alias_as_name (可选) | 指定是将输入字段名称还是字段别名用作输出字段名称。
| Boolean |
field_mapping (可选) | 将字段及其各自属性和源字段传输到输出数据集中。 默认情况下,输出包括来自输入数据集的所有字段。 使用字段映射来添加、删除、重命名和重新排序字段,以及更改其他字段属性。 字段映射还可以用于将两个或多个输入字段的值合并为单个输出字段。 | Field Mappings |
sort_field [sort_field,...] (可选) | 包含对输入记录重新排序所用的值的一个或多个字段,以及记录的排序方向。
| Value Table |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 ExportFeatures 函数。
import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportFeatures("streets", "C:/output/output.gdb/streets")
以下独立脚本演示了如何使用 ExportFeatures 函数。
# Name: ExportFeatures_Example2.py
# Description: Use Export Features with an expression to create a subset of the
# original feature class.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/SFValley.gdb"
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"
# Run ExportFeatures
arcpy.conversion.ExportFeatures(inFeatures, outFeatureClass, expression,
"NOT_USE_ALIAS")