InsertCursor

Synthèse

Inserts rows of attribute values into a specified feature class or table.

The InsertCursor function returns an enumeration object that distributes Row objects.

Discussion

Héritage :

This function was superceded by arcpy.da.InsertCursor at ArcGIS 10.1. For faster performance, use arcpy.da.InsertCursor.

New Row objects can be obtained using the newRow method on the enumeration object into which rows are to be inserted. Each call to insertRow on the cursor creates a row in the table whose initial values are set to the values in the input row.

Syntaxe

InsertCursor (dataset, {spatial_reference})

Paramètre	Explication	Type de données
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

Valeur renvoyée

Type de données	Explication
Cursor	Returns a Cursor object against the specified feature class, shapefile, or table.

Exemple de code

InsertCursor example

Inserts 25 new rows into a table.

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