InsertCursor

Краткая информация

Вставляет строку атрибутивных значений в указанный класс объектов или в таблицу.

Функция InsertCursor возвращает объект перечисления, который распределяет объекты Row.

Обсуждение

Прежние версии:

Эта функция была заменена на arcpy.da.InsertCursor в ArcGIS 10.1. Для лучшей производительности, используйте arcpy.da.InsertCursor.

Новые объекты Row могут быть получены с помощью метода 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	Возвращает объект 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