InsertCursor

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

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

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

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

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

Обсуждение

Новые объекты Row могут быть получены с помощью метода newRow на объекте перечисления, в который должны быть вставлены строки. Каждый вызов insertRow для курсора создает новую строку в таблице с начальными значениями, соответствующими значениям во входной строке.

Синтаксис

InsertCursor (dataset, {spatial_reference})

Параметр	Описание	Тип данных
dataset	The feature class or table 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 an insert cursor for a 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