DataRow.HasErrors プロパティ

.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

C#

public bool HasErrors { get;
 }

C++

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

J#

/** @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

C#

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();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataRow クラス
DataRow メンバ
System.Data 名前空間
ClearErrors
DataColumnCollection クラス
GetColumnError
GetColumnsInError
SetColumnError