DataTable.HasErrors Property

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataTable.cs

Gets a value indicating whether there are errors in any of the rows in any of the tables of the DataSet to which the table belongs.

public:
 property bool HasErrors { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool HasErrors { get; }

[<System.ComponentModel.Browsable(false)>]
member this.HasErrors : bool

Public ReadOnly Property HasErrors As Boolean

Property Value

Boolean

true if errors exist; otherwise false.

Attributes

BrowsableAttribute

Examples

The following example uses the HasErrors property to check if a table contains errors.

private void CheckForErrors(DataSet dataSet)
{
    // Invoke GetChanges on the DataSet to create a reduced set.
    DataSet thisDataSet = dataSet.GetChanges();

    // Check each table's HasErrors property.
    foreach(DataTable table in thisDataSet.Tables)
    {
        // If HasErrors is true, reconcile errors.
        if(table.HasErrors)
        {
            // Insert code to reconcile errors.
        }
    }
}

Private Sub CheckForErrors(dataSet As DataSet)
    ' Invoke GetChanges on the DataSet to create a reduced set.
    Dim thisDataSet As DataSet = dataSet.GetChanges()

    ' Check each table's HasErrors property.
    Dim table As DataTable
    For Each table In thisDataSet.Tables
        ' If HasErrors is true, reconcile errors.
        If table.HasErrors Then
            ' Insert code to reconcile errors.
        End If
    Next table
End Sub

Remarks

As users work on a set of data contained in a DataTable, you can mark each change with an error if the change causes some validation failure. You can mark an entire DataRow with an error message using the RowError property. You can also set errors on each column of the row with the SetColumnError method.

Before updating a data source with a DataSet, it's recommended that you first invoke the GetChanges method on the target DataSet. The method results in a DataSet that contains only the changes made to the original. Before sending the DataSet to the data source for updating, check the HasErrors property of each table to see if any errors have been attached to the rows or columns in the rows.

After reconciling each error, clear the errors with the ClearErrors method of the DataRow.

See also

• GetErrors()
• DataTables