com.esri.arcgis.geodatabase
Interface IDifferenceCursorEx

All Superinterfaces:

Serializable

All Known Implementing Classes:

IDifferenceCursorExProxy

public interface IDifferenceCursorEx
extends Serializable

Provides access to members that control the difference cursor.

Description

The IDifferenceCursorEx interface returns a cursor of OIDs and two IRows based upon the difference type used with IDataChangesEx::ExtractEx.

Remarks

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 been deleted yet.

Product Availability

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

Method Summary

void	next(int[] oID, IRow[] sourceRow, IRow[] differenceRow, ILongArray[] differentValueIndices) Returns the source row, the difference row and an array with indices of fields with different values.

Method Detail

next

void next(int[] oID,
          IRow[] sourceRow,
          IRow[] differenceRow,
          ILongArray[] differentValueIndices)
          throws IOException,
                 AutomationException

Returns the source row, the difference row and an array with indices of fields with different values.

Remarks

The Next method can be used to populate two IRow objects corresponding to the SourceRow, DifferenceRow and a LongArray corresponding to the field index values.

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 IDifferenceCursorEx::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.

Parameters:

oID - The oID (out: use single element array)

sourceRow - A reference to a com.esri.arcgis.geodatabase.IRow (out: use single element array)

differenceRow - A reference to a com.esri.arcgis.geodatabase.IRow (out: use single element array)

differentValueIndices - A reference to a com.esri.arcgis.system.ILongArray (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.