InsertCursor

摘要

将属性值的行插入指定要素类或表。

InsertCursor 函数可返回一个分发 Row 对象的枚举对象。

说明

旧版本：

自 ArcGIS 10.1 起，此功能已由 arcpy.da.InsertCursor 取代。 为了获得更快性能，请使用 arcpy.da.InsertCursor。

可使用 newRow 方法从插入行的枚举对象获取新的 Row 对象。 光标每次调用 insertRow 都会在表中创建行，该行的初始值设置为输入行中的值。

语法

InsertCursor (dataset, {spatial_reference})

参数	说明	数据类型
dataset	The table, feature class, or shapefile into which rows will be inserted.	String
spatial_reference	Coordinates are specified in the spatial_reference provided and converted on the fly to the coordinate system of the dataset.	SpatialReference

返回值

数据类型	说明
Cursor	返回针对指定要素类、shapefile 或表的 Cursor 对象。

代码示例

InsertCursor 示例

向表中插入 25 个新行。

import arcpy

# Create insert cursor for table
rows = arcpy.InsertCursor("c:/base/data.gdb/roads_lut")

# Create 25 new rows. Set the initial row ID and distance values
for x in range(1, 26):
    row = rows.newRow()
    row.setValue("rowid", x)
    row.setValue("distance", 100)
    rows.insertRow(row)

# Delete cursor and row objects to remove locks on the data
del row
del rows