ArcGIS Pro 3.4 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 or higher.
    See Also