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