GridControl.BeginUpdate() Method

Locks the GridControl object by preventing visual updates of the object and its elements until the EndUpdate method is called.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v17.2.dll

Declaration

C#

public virtual void BeginUpdate()

VB.NET

Public Overridable Sub BeginUpdate

Remarks

The BeginUpdate and GridControl.EndUpdate methods can be used to prevent excessive visual updates to the currently opened Views. After the BeginUpdate method has been called, the currently opened Views are locked, and do not reflect any changes made to their appearance settings. Calling the GridControl.EndUpdate method unlocks and redraws the Views.

To prevent excessive updates in a single View, use the BaseView.BeginUpdate and BaseView.EndUpdate methods.

The BeginUpdate and EndUpdate methods do not prevent grid updates caused by data-aware operations (for instance, adding and deleting records, sorting and grouping data). To prevent the grid from being updated in these instances, call the BaseView.BeginDataUpdate and BaseView.EndDataUpdate methods.

Note

Do not set the GridControl.MainView property while wrapping the setter with the GridControl.BeginUpdate and GridControl.EndUpdate method pair. Instead, set the GridControl.MainView property outside the BeginUpdate/EndUpdate block.

Refer to the Batch Modifications Overview topic, for information on batch modifications.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BeginUpdate() 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#

XDL_how-to-convert-the-criteriaoperator-to-a-lambda-expression-to-use-it-for-iqueryable-e2596/CS/WindowsFormsApplication152/Form1.cs#L57

{
    gridControl1.BeginUpdate();
    try

how-to-customize-the-resulting-file-during-printing-exporting-gridcontrol-e2722/CS/WindowsApplication1/GridExportHelper.cs#L50

{
    _GridControl.BeginUpdate();

how-to-expand-visible-group-rows-when-the-user-searches-using-the-find-panel-e3903/CS/FindPanelExample/MainForm.cs#L15

InitializeComponent();
GridControl.BeginUpdate();
try {

how-to-use-the-layoutview-cardview-as-a-master-view-in-master-detail-mode-e2428/CS/WindowsApplication3/MasterDetailHelper.cs#L115

void OnPopup(object sender, EventArgs e) {
    DetailGrid.BeginUpdate();
    try {

VB.NET

XDL_how-to-convert-the-criteriaoperator-to-a-lambda-expression-to-use-it-for-iqueryable-e2596/VB/WindowsFormsApplication152/Form1.vb#L49

Private Sub OnUpdateFilter(ByVal sender As Object, ByVal e As EventArgs) Handles simpleButton1.Click
    gridControl1.BeginUpdate()
    Try

how-to-customize-the-resulting-file-during-printing-exporting-gridcontrol-e2722/VB/GridExportHelper.vb#L41

Private Sub LockUpdate()
    _GridControl.BeginUpdate()

how-to-expand-visible-group-rows-when-the-user-searches-using-the-find-panel-e3903/VB/FindPanelExample/MainForm.vb#L17

InitializeComponent()
GridControl.BeginUpdate()
Try

how-to-use-the-layoutview-cardview-as-a-master-view-in-master-detail-mode-e2428/VB/WindowsApplication3/MasterDetailHelper.vb#L126

Private Sub OnPopup(ByVal sender As Object, ByVal e As EventArgs)
    DetailGrid.BeginUpdate()
    Try