InsertCursor (arcpy)

摘要

向要素类、shapefile 或表中插入行。InsertCursor 返回一个分发行对象的枚举对象。

讨论

可使用 newRow 方法从插入行的枚举对象获取新的行对象。每次调用光标上 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 或表的光标对象。

代码实例

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 xrange(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