ArcGIS Pro 3.1 API Reference Guide
ArcGIS.Core.Data Namespace / Table Class / CreateInsertCursor Method
Example Version

    CreateInsertCursor Method
    Creates an InsertCursor instance in memory. This method must be called on the MCT. Use QueuedTask.Run.
    Syntax
    public InsertCursor CreateInsertCursor()

    Return Value

    A InsertCursor used to quickly insert rows.
    Exceptions
    ExceptionDescription
    A geodatabase-related exception has occurred.
    Remarks
    When used in an ArcGIS Pro add-in, insert cursors should be used within an edit operation callback. For stand-alone CoreHost applications, calls to this method (and use of the insert cursor) should be enclosed within a call to Geodatabase.ApplyEdits.
    Example
    Using an Insert Cursor
    // Insert Cursors are intended for use in CoreHost applications, not Pro Add-ins
    public void UsingInsertCursor()
    {
      using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file"))))
      using (Table citiesTable = geodatabase.OpenDataset<Table>("name\\of\\cities_table"))
      {
        geodatabase.ApplyEdits(() =>
        {
          using (InsertCursor insertCursor = citiesTable.CreateInsertCursor())
          using (RowBuffer rowBuffer = citiesTable.CreateRowBuffer())
          {
            rowBuffer["State"] = "Colorado";
    
            rowBuffer["Name"] = "Fort Collins";
            rowBuffer["Population"] = 167830;
            insertCursor.Insert(rowBuffer);
    
            rowBuffer["Name"] = "Denver";
            rowBuffer["Population"] = 727211;
            insertCursor.Insert(rowBuffer);
    
            // Insert more rows here
            // A more realistic example would be reading source data from a file
    
            insertCursor.Flush();
          }
        });
      }
    }
    Requirements

    Target Platforms: Windows 11, Windows 10

    ArcGIS Pro version: 3.0 or higher.
    See Also