ITable.Insert Method

Returns a cursor that can be used to insert new Rows.

[Visual Basic .NET]
Public Function Insert ( _
    ByVal useBuffering As Boolean _
) As ICursor

[C#]
public ICursor Insert (
    bool useBuffering
);

[C++]
HRESULT Insert(
  VARIANT_BOOL useBuffering,
  ICursor** Cursor
);

[C++]
Parameters
useBuffering [in]
  useBuffering is a parameter of type VARIANT_BOOL
Cursor [out, retval]
  Cursor is a parameter of type ICursor

Product Availability

Remarks

The Insert method returns an insert cursor that can be used to bulk insert rows. It offers significantly faster performance than multiple calls to CreateRow and Store for tables storing simple rows and simple features (that is, for tables whose CLSID is esriGeoDatabase.Row, esriGeoDatabase.Object, or esriGeoDatabase.Feature).

Insert cursors on tables containing complex objects use the CreateRow and Store methods to achieve polymorphism, and there is no difference in performance in these cases.

When using cursors within an edit session, they should always be scoped to edit operations. In other words, a cursor should be created after an edit operation has begun and should not be used once that edit operation has been stopped or aborted.

See Also