BeginUpdate Method (C1FlexGridBase)

In This Topic

Maintains performance by preventing the control from updating itself until the EndUpdate method is called.

Syntax

Visual Basic
C#

'Declaration
 
Public Overrides Sub BeginUpdate()

public override void BeginUpdate()

Remarks

The BeginUpdate and EndUpdate methods are used to optimize the performance of the grid. Call BeginUpdate before making extensive changes, and call EndUpdate when done to suspend repainting. This will reduce flicker and increase performance. This optimization is especially effective when adding large numbers of rows to the grid, because it needs to recalculate ranges and update scrollbars each time a row is added.

Example

The code below shows how to add a large number of rows to the grid efficiently. Note how the EndUpdate method is called inside a 'finally' block to ensure repainting is properly restored.

void UpdateGrid(C1FlexGrid flex)
{
  try
  {
    flex.BeginUpdate(); // suspend painting to avoid flicker
    flex.Rows.Count = 1;
    for (int i = 1; i < 10000; i++)
      flex.AddItem("Row " + i.ToString());
  }
  finally
  {
    flex.EndUpdate(); // always restore painting
  }
}

Reference

C1FlexGridBase Class
C1FlexGridBase Members