InsertCursor

描述

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

讨论

旧版本：

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

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

语法

InsertCursor (dataset, {spatial_reference})

参数	说明	数据类型
dataset	将向其中插入行的表、要素类或 shapefile。	String
spatial_reference	在提供的 spatial_reference 中指定的坐标，并动态转换到数据集的坐标系。	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