C1.Win.C1FlexGrid.Util.BaseControls.ScrollableControl.DeferUpdate

DeferUpdate Method

DeferUpdate()

Suspends notifications until the returned IDisposable object is disposed.

Declaration

public IDisposable DeferUpdate()

Returns

Type	Description
IDisposable	An IDisposable object that must be disposed to restore notifications.

Remarks

This method is typically used in update blocks to perform batch updates efficiently and safely.

Examples

The example below shows how you can use the DeferUpdate method to suspend notifications while setting the width of several columns.

Note that the call to the DeferUpdate method is placed in a using statement, which automatically disposes of the object and restores updates at the end of the block, even if the code within the block throws an exception. This makes the code more readable and concise than calling the more traditional BeginUpdate and EndUpdate methods within a try/finally block.

var grid = new C1FlexGrid();
using (grid.DeferUpdate())
{
  foreach (Column col in grid.Columns)
  {
    col.Width = 100;
  }
}