DataRow.HasErrors Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a value that indicates whether there are errors in a row.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

Public ReadOnly Property HasErrors As Boolean

Property Value

Type: System.Boolean

true if the row contains an error; otherwise, false.

HasErrors returns true if any DataColumn object in the row contains an error, or if the RowError property of the DataRow is not an empty string.

When validating data, you can set an error on any column in a row. Such a column, when displayed in the System.Windows.Forms.DataGrid control, is marked with a red exclamation point to signal to the user that the column is in error.

Use SetColumnError to set an error on any column.

Use the GetColumnError and GetColumnsInError methods to return columns with errors.

The ClearErrors method clears all errors for the row.

The following example uses the HasErrors to look for errors. If the row has errors, the GetColumnsInError method returns the array of columns with errors that can then be resolved. The ClearErrors method is then called to clear all errors.

Private Sub GetAllErrs(ByVal row As DataRow)
    ' Declare an array variable for DataColumn objects.
    Dim colArr() As DataColumn 

    ' If the Row has errors, check use GetColumnsInError.
    Dim i As Integer
    If row.HasErrors Then 
       ' Get the array of columns in error.
       colArr = row.GetColumnsInError()
       For i = 0 to colArr.Length - 1
          ' Insert code to fix errors on each column.
          Console.WriteLine(colArr(i).ColumnName)
       Next i

    ' Clear errors after reconciling.
    row.ClearErrors()
    End If
End Sub

.NET Framework
Available since 1.1
Return to top
Show: