ArcObjects Library Reference (GeoDatabase)

Row CoClass

Esri Row object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces	Description
IRelatedObjectEvents	Provides access to events that occur when related objects change, move or rotate.
IRow	Provides access to members that return information about the row, the table the row belongs to and storing and deleting the row.
IRowBuffer	Provides access to members used for getting and modifying a rows values and for getting the fields in the row.
IRowChanges	Provides access to members that return information about changed values and the original value in a row.
IRowCompare	Provides access to a member that compares two rows.
IRowEdit	Provides access to members implemented to customize object editing.
IRowEvents	Provides access to events that occur when an object is modified, created or deleted.
IRowSubtypes	Provides access to members to return and modify the subtype code and to initialize the default values.
ISupportErrorInfo	Indicates whether a specific interface can return Automation error objects.
IValidate	Provides access to members to validate individual features.

Remarks

A Row object is an instantiated software object that represents a persistent row in a Table. A row object is normally obtained from a cursor on a table (for example, ICursor::NextRow) or fetched directly given its object ID (for example, ITable::GetRow).

Once retrieved, clients may query the row object for additional interfaces and invoke methods on the row object. The CLSID property of a Table determines the type of row object returned by the Table. A new persistent row object is created using the ITable::CreateRow method. The act of creating the row assigns it identity. Note that applications should use the CreateRow method to create new persistent row objects as opposed to directly cocreating the row objects. The latter will not create a row in the underlying persistent store.

A Row has a set of Fields. The set of Fields for a Row is the same as the set of Fields for its Table. In particular, the numeric index of a field in the Fields collection of its table is the same as the numeric index of the field in the Fields collec-tion of the row, which is the same as the numeric index used to access the value of the field from the row. This means that application programs can and should cache field numeric indexes using the FindField method on the Table object, rather than invoke the FindField method once per row returned by a Cursor.