ColumnView.DataError Event

Fires when an error occurs in the data controller and allows you to handle the error.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v24.1.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Action")]
public event EventHandler<ColumnViewDataErrorEventArgs> DataError

VB.NET

<DXCategory("Action")>
Public Event DataError As EventHandler(Of ColumnViewDataErrorEventArgs)

Event Data

The DataError event's data class is DevExpress.XtraGrid.Views.Base.ColumnViewDataErrorEventArgs.

Remarks

The grid control displays a tooltip if there is an error in the data controller:

The DataError event allows you to handle errors in the data controller.

You can modify the error message displayed in the tooltip:

C#

using DevExpress.XtraGrid.Views.Base;

void gridView1_DataError(object sender, ColumnViewDataErrorEventArgs e) {
    e.DisplayMessage = "Specify a custom error message.";
}

VB.NET

Imports DevExpress.XtraGrid.Views.Base

Private Sub gridView1_DataError(ByVal sender As Object, ByVal e As ColumnViewDataErrorEventArgs)
    e.DisplayMessage = "Specify a custom error message."
End Sub

Set the e.Handled property to true to hide the tooltip. The following example logs the error and hides the tooltip:

C#

using DevExpress.XtraGrid.Views.Base;

void gridView1_DataError(object sender, ColumnViewDataErrorEventArgs e) {
    Log(e.DataException.Message);
    e.Handled = true;
}

VB.NET

Imports DevExpress.XtraGrid.Views.Base

Private Sub gridView1_DataError(ByVal sender As Object, ByVal e As ColumnViewDataErrorEventArgs)
    Log(e.DataException.Message)
    e.Handled = True
End Sub