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 outbound row 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 value returned by the outbound OID parameter 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.

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.