DataControlBase.BeginDataUpdate() Method

Locks visual and internal data updates within the GridControl. Call the DataControlBase.EndDataUpdate method to apply all pending changes and resume updates.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.1.Core.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public void BeginDataUpdate()

VB.NET

Public Sub BeginDataUpdate

Remarks

If you lock the GridControl, a user cannot change data within the control. You can accumulate changes and update data in one action. As a result, you can improve performance of the GridControl when you perform data shaping operations. Call the DataControlBase.EndDataUpdate method to apply the pending changes.

A DataControlBase.EndDataUpdate method call should follow every BeginDataUpdate method call.

Refer to the following topic for information on how to lock updates within the GridControl: Frequent Data Updates.

The TreeListView saves a node state (selected or expanded) when you call the BeginDataUpdate method and restores this state when you call DataControlBase.EndDataUpdate. If you want to save a new node state, call the TreeListView.SaveNodesState method before DataControlBase.EndDataUpdate.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BeginDataUpdate() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-custom-columnchooser-that-allows-arranging-columns-by-dragdrop-e3368/CS/MainWindow.xaml.cs#L115

void AllLeftButton_Click(object sender, RoutedEventArgs e) {
    View.DataControl.BeginDataUpdate();
    foreach(GridColumn column in ((GridViewBase)View).ColumnChooserColumns) {

wpf-data-grid-update-data-in-a-separate-thread/CS/GridUpdateService.cs#L18

if (GridControl != null) {
    GridControl.BeginDataUpdate();
}

wpf-data-grid-process-frequent-data-updates/CS/BeginEndDataUpdateExample/GridUpdateService.cs#L19

public void BeginDataUpdate() {
    Grid.BeginDataUpdate();
}

wpf-data-grid-call-begindataupdate-and-enddataupdate-at-view-model-level/CS/BeginEndDataUpdate/CustomService.cs#L27

public void BeginUpdate() {
    ActuaGridControl.BeginDataUpdate();
}

VB.NET

how-to-create-a-custom-columnchooser-that-allows-arranging-columns-by-dragdrop-e3368/VB/MainWindow.xaml.vb#L122

Private Sub AllLeftButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    View.DataControl.BeginDataUpdate()
    For Each column As GridColumn In CType(View, GridViewBase).ColumnChooserColumns

wpf-data-grid-update-data-in-a-separate-thread/VB/GridUpdateService.vb#L28

If GridControl IsNot Nothing Then
    GridControl.BeginDataUpdate()
End If

wpf-data-grid-process-frequent-data-updates/VB/BeginEndDataUpdateExample/GridUpdateService.vb#L17

Public Sub BeginDataUpdate() Implements IGridUpdateService.BeginDataUpdate
    Grid.BeginDataUpdate()
End Sub

wpf-data-grid-call-begindataupdate-and-enddataupdate-at-view-model-level/VB/BeginEndDataUpdate/CustomService.vb#L31

Public Sub BeginUpdate() Implements ICustomService.BeginUpdate
    ActuaGridControl.BeginDataUpdate()
End Sub