ComponentOne FlexPivot for WinForms
C1.Win.C1FlexGrid.4.5.2 Assembly / C1.Win.C1FlexGrid Namespace / C1FlexGridBase Class / AddItem Method / AddItem(String) Method
String containing the data for the new row. Items are separated by tab characters by default. You can change the separator character using the ClipSeparators property.
Example

In This Topic
    AddItem(String) Method
    In This Topic
    Adds a row to the grid and populates the new row with data.
    Syntax
    'Declaration
     
    Public Overloads Function AddItem( _
       ByVal item As String _
    ) As Row
    public Row AddItem( 
       string item
    )

    Parameters

    item
    String containing the data for the new row. Items are separated by tab characters by default. You can change the separator character using the ClipSeparators property.

    Return Value

    A reference to the new row.
    Remarks

    You can also add and remove rows using the Rows collection. The AddItem(String) method provides a concise syntax for creating the row, populating it with data, and then adding it to the grid.

    Before using AddItem(String) to add a large number of rows to the grid, remember to set the Redraw property to false. When finished adding the rows, set Redraw back to its original value. This will significantly improve performance.

    Example
    The code below adds 300 rows to the grid.
    // suspend painting to improve performance
    bool redraw = flex.Redraw;
    flex.Redraw = false;
                
    // append 100 rows, using tabs as separators
    flex.ClipSeparators = "\t\n";
    for (int i = 0; i < 100; i++)
      flex.AddItem("\tcol1\tcol2\tcol3");
      
    // add 100 rows at the top, using pipes as separators
    flex.ClipSeparators = "|;";
    for (int i = 0; i < 100; i++)
      flex.AddItem("|col1|col2|col3", 0);
      
    // append 100 rows at the bottom, using an object array
    object[] items = { "col1", "col2", "col3" };
    for (int i = 0; i < 100; i++)
      flex.AddItem(items, flex.Rows.Count, flex.Cols.Fixed);
      
    // restore painting
    flex.Redraw = redraw;
    See Also