 |
This document is archived and information here might be outdated. Recommended version. |
Row Class (ArcObjects .NET 10.8 SDK)
|
This document is archived and information here might be outdated. Recommended version. |
Esri Row object.
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 | 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 (esriSystem) | |
| IValidate | Provides access to members to validate individual features. |
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.