ASPxPivotGrid.EndUpdate() Method

Re-enables render operations after a call to the ASPxPivotGrid.BeginUpdate method and forces an immediate re-rendering.

Namespace: DevExpress.Web.ASPxPivotGrid

Assembly: DevExpress.Web.ASPxPivotGrid.v19.2.dll

Declaration

public void EndUpdate()
Public Sub

Remarks

The ASPxPivotGrid allows a sequence of operations that affect its appearance and/or functionality to be performed without having the control render itself after each modification. To do this, the code performing sequential changes to the ASPxPivotGrid must be enclosed within calls to the ASPxPivotGrid.BeginUpdate and ASPxPivotGrid.EndUpdate methods. This improves performance and avoids unnecessary render operations.

The ASPxPivotGrid.BeginUpdate method locks the pivot grid control until the EndUpdate method is called. Any changes made after a call to the ASPxPivotGrid.BeginUpdate method don't force the control to update itself. The EndUpdate method invalidates and unlocks the pivot grid so that any further changes are applied immediately.

If the ASPxPivotGrid.BeginUpdate method has been called several times, the EndUpdate method must be called as many times as the ASPxPivotGrid.BeginUpdate. Otherwise, the control stays locked. To ensure that the EndUpdate method is always called even if an exception occurs, wrap any calls to ASPxPivotGrid.BeginUpdate and EndUpdate methods in a try...finally statement.

See Also