DataRow.HasErrors プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataRow.HasErrors プロパティ

行にエラーがあるかどうかを示す値を取得します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 HasErrors As Boolean

Visual Basic (使用法)

Dim instance As DataRow
Dim value As Boolean

value = instance.HasErrors

public bool HasErrors { get;
 }

C++

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

/** @property */
public boolean get_HasErrors ()

JScript

public function get HasErrors
 () : boolean

プロパティ値
行にエラーがある場合は true。それ以外の場合は false。

解説

行内の DataColumn オブジェクトにエラーがある場合、または DataRow の RowError プロパティが空の文字列の場合、HasErrors は true を返します。

データを検証するときに、行内の任意の列にエラーを設定できます。System.Windows.Forms.DataGrid コントロールに表示されたときに、エラーが設定されている列には、エラーがあることをユーザーに知らせる赤い感嘆符が付いています。

SetColumnError を使用して、いずれかの列にエラーを設定します。

GetColumnError メソッドと GetColumnsInError メソッドを使用して、エラーがある列を返します。

ClearErrors メソッドを使用して、その行のすべてのエラーを消去します。

使用例

HasErrors を使用してエラーの有無を確認する例を次に示します。行にエラーがある場合、エラーがある列の配列を GetColumnsInError メソッドが返すので、これらのエラーを解決します。次に、ClearErrors メソッドを呼び出して、すべてのエラーをクリアします。

Visual Basic

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

private void GetAllErrs(DataRow row)
{
    // Declare an array variable for DataColumn objects.
    DataColumn[] colArr; 
    // If the Row has errors, check use GetColumnsInError.
    if(row.HasErrors)
    {
        // Get the array of columns in error.
        colArr = row.GetColumnsInError();
        for(int i = 0; i < colArr.Length;
 i++)
        {
            // Insert code to fix errors on each column.
            Console.WriteLine(colArr[i].ColumnName);
        }
        // Clear errors after reconciling.
        row.ClearErrors();
    }
}