C1.Win.FlexGrid.C1FlexGridBase.BeginUpdate

BeginUpdate Method

BeginUpdate()

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

Declaration

public override void BeginUpdate()

Overrides

ScrollableControl.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.

Examples

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
  }
}