Data Cursors

A Data Cursor is a GISDK object that provides an alternative method of navigating and reading tabular data; for information on the old method, see Reading and Writing Data. You use CreateDataCursor() to create a Data Cursor for either a whole table or layer, with an optional selection set. You can specify additional options for the Data Cursor, such as the order of navigation of the records and which fields to pre-fetch. You can also identify a value for a field against which to match records.

Data Cursor objects have the following properties and methods:

Property

Example

Description

Record

record_handle = cursor.Record

The current record pointed at by the Data Cursor

record_ID = cursor.ID

The ID of the current record pointed at by the Data Cursor (for layers only)

Method	Example	Description
Fetch	record_handle = cursor.Fetch()	Moves to the next record and returns the record handle, or null if no more records
GetValue	value = cursor.GetValue(string field_name)	Reads the value of field_name for the current record and returns the value
GetValues	values = cursor.GetValues(array field_names)	Reads the values of field_names for the current record and returns an array of values