IDifferenceCursor Interface

Provides access to members that control the version difference cursor.

Description

The IDifferenceCursor interface returns a cursor of OIDsand IRowsbased upon the difference type used with IVersionedTableor IDataChangesEx.

The set of object IDs returned is dependant on the difference type category. For example, if the difference type DeleteNoChangeis 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.

IRowobjects 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.

Members

Name Description
Method Next Returns the object identifier or difference row.

IDifferenceCursor.Next Method

Returns the object identifier or difference row.

Public Sub Next ( _
    ByRef OID As Int64&, _
    ByRef differenceRow As IRow _
)
public void Next (
    ref Int64& OID,
    ref IRow differenceRow
);

Remarks

The Nextmethod returns an object ID of an IRow.

IRowobjects 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.

Classes that implement IDifferenceCursor

Classes Description
DifferenceCursor Esri Difference Cursor object.
// Get inserts made into the table 

private void ViewInsertsMadeToTable(ITable table)

{

    IVersionedTable versionedTable = (IVersionedTable)table;

    QueryFilter queryFilter = new QueryFilter

    {

      WhereClause = "OBJECTID > 0"

    };



    IDifferenceCursor diffCursor = versionedTable.Differences(table, esriDifferenceType.esriDifferenceTypeInsert, queryFilter);

long OID;

IRow diffRow;

diffCursor.Next(out OID, out diffRow); // Loop through the cursor

}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.