ArcObjects Library Reference  (GeoDatabase)    

ITable.Insert Method

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

[Visual Basic 6.0]
Function Insert(
    ByVal useBuffering As Boolean _
) As ICursor
[Visual Basic .NET]
Public Function Insert ( _
    ByVal useBuffering As Boolean _
) As ICursor
[C#]
public ICursor Insert (
    bool useBuffering
);
[Java]
public ICursor insert (
    Boolean useBuffering
)
throws
    IOException,
    AutomationException
[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

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

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.

See Also

ITable Interface