GridControl.RefreshDataSource() Method

Updates the GridControl.MainView to reflect changes made to a data source.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

public virtual void RefreshDataSource()

VB.NET

Public Overridable Sub RefreshDataSource

Remarks

Call the RefreshDataSource method to update data displayed within the grid control’s GridControl.MainView. The method reloads all records from the grid’s associated data source for this purpose. Note that calling the method makes sense only when the bound data source doesn’t support the IBindingList interface. Otherwise, the control will automatically update itself.

Important

These automatic updates include information about added and\or removed rows. Changes made to existing rows are not recognized, unless the data source IBindingList object implements the System.ComponentModel.INotifyPropertyChanged interface.

To reload data within detail Views, use the ColumnView.RefreshData method.

Note

Do not call the RefreshDataSource method if you only need to update certain rows, since this method forces the entire grid to re-draw and negatively affects the application performance. In this scenario, utilize the ColumnView.RefreshRow method instead.

Related GitHub Examples

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

machine-learning-chart-demo-e20012/CS/MachineLearningDemo/Main.cs#L35

gridStudent.DataSource = _data;
gridStudent.RefreshDataSource();
_subject = new Student { Name = "Seth", GPA = 3.5, Age = 31, Grade = Grade.A, Tall = false, Friends = 15 };

XPO_tutorial-3-querying-data-e4559/CS/XpoTutorial3/XtraForm1.cs#L45

    xpCollection1.Criteria = new BinaryOperator("Age", spinEdit1.Value, BinaryOperatorType.Greater);
    gridControl1.RefreshDataSource();
}

VB.NET

machine-learning-chart-demo-e20012/VB/MachineLearningDemo/Main.vb#L33

gridStudent.DataSource = _data
gridStudent.RefreshDataSource()
_subject = New Student With { _

XPO_tutorial-3-querying-data-e4559/VB/XpoTutorial3/XtraForm1.vb#L47

    xpCollection1.Criteria = New BinaryOperator("Age", spinEdit1.Value, BinaryOperatorType.Greater)
    gridControl1.RefreshDataSource()
End Sub