com.esri.arcgis.geodatabase
Interface IDifferenceCursor

All Superinterfaces:
Serializable
All Known Implementing Classes:
DifferenceCursor, IDifferenceCursorProxy

public interface IDifferenceCursor
extends Serializable

Provides access to members that control the version difference cursor.

Description

The IDifferenceCursor interface returns a cursor of OIDs and IRows based upon the difference type used with IVersionedTable or IDataChangesEx.

The set of object IDs returned is dependant on the difference type category. For example, if the difference type DeleteNoChange is applied, the cursor will be nothing since the row no longer exists. In this case it is necessary to enumerate until the returned OID equals -1. Use the OID returned in the cursor to retrieve the row in the other version of the table where the row has not yet been deleted.

IRow objects returned from a difference cursor are meant to be a read only. If row editing is desired the OID returned from the call to IDifferenceCursor::NextRow should be used in a call to the ITable::GetRow or ITable::GetRows methods.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 void next(int[] oID, IRow[] differenceRow)
          Returns the object identifier or difference row.
 

Method Detail

next

void next(int[] oID,
          IRow[] differenceRow)
          throws IOException,
                 AutomationException
Returns the object identifier or difference row.

Remarks

The Next method returns an object ID of an IRow.

IRow objects returned from a difference cursor are meant to be a read only. If row editing is desired the OID returned from the call to IDifferenceCursor::NextRow should be used in a call ITable::GetRow or ITable::GetRows methods.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
oID - The oID (out: use single element array)
differenceRow - A reference to a com.esri.arcgis.geodatabase.IRow (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.