ArcMap

Cursor

摘要

Cursor 是一种数据访问对象，可用于在表中迭代一组行或者向表中插入新行。游标有三种形式：搜索、插入或更新。游标通常用于读取和更新属性。

方法概述

方法说明
deleteRow (row)

删除数据库中的某一行。将删除与游标当前所在位置相对应的行。

insertRow (row)

向数据库中插入新行。

newRow ()

创建空行对象。

next ()

返回当前索引中的下一个对象。

reset ()

将当前枚举索引（由 next 方法使用）设置回第一个元素。

updateRow (row)

updateRow 方法可用于对更新游标当前所在的行进行更新。

方法

deleteRow (row)
参数说明数据类型
row

要删除的行。

Row
insertRow (row)
参数说明数据类型
row

要插入的行。

Row
newRow ()

返回值

数据类型说明
Row

新的空行对象。

next ()

返回值

数据类型说明
Object

当前索引中的下一个对象。

reset ()
updateRow (row)
参数说明数据类型
row

用于更新游标当前所在位置的行。

Row

代码示例

Cursor 示例 1

使用搜索游标查看行中的字段值。

import arcpy

# Set the workspace
arcpy.env.workspace = "c:/base/data.gdb"

# Create the search cursor
cursor = arcpy.SearchCursor("roads", '"TYPE" <> 4')

# Iterate through the rows in the cursor
for row in cursor:
    print("Name: {0},  CFCC code: {1}".format(row.NAME, row.CFCC))

del cursor, row
Cursor 示例 2

使用更新游标更改行中的字段值。

import arcpy

# Set the workspace
arcpy.env.workspace = "c:/base/data.gdb"

# Create the update cursor
cursor = arcpy.UpdateCursor("roads")

# Update the road buffer distance field based on road type.
#   Road type is either 1,2,3,4  Distance is in meters.
for row in cursor:
    row.setValue("BUFFER_DIST", row.getValue("TYPE") * 100)
    cursor.updateRow(row)

# Delete cursor and row objects
del cursor, row
Cursor 示例 3

使用插入游标在表中新建行。

import datetime
import arcpy

# Create insert cursor for table
cursor = arcpy.InsertCursor("c:/base/data.gdb/roads_maint")

# Create 25 new rows. Set default values on distance and CFCC code
for i in range(1000, 1025):
    row = cursor.newRow()
    row.setValue('rowid', i)
    row.setValue('distance', 100)
    row.setValue('CFCC', 'A10')
    row.setValue('LastInsp', datetime.datetime.now())
    cursor.insertRow(row)

# Delete cursor and row objects
del cursor, row

相关主题