DataRow.GetColumnsInError メソッド

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

DataRow.GetColumnsInError メソッド

エラーが含まれる列の配列を取得します。

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

Visual Basic (宣言)

Public Function GetColumnsInError As
 DataColumn()

Visual Basic (使用法)

Dim instance As DataRow
Dim returnValue As DataColumn()

returnValue = instance.GetColumnsInError

C#

public DataColumn[] GetColumnsInError ()

C++

public:
array<DataColumn^>^ GetColumnsInError ()

J#

public DataColumn[] GetColumnsInError ()

JScript

public function GetColumnsInError () : DataColumn[]

戻り値
エラーが含まれる DataColumn オブジェクトの配列。

解説

GetColumnsInError を使用すると、エラーが含まれる列だけが返されるため、エラー処理が必要な DataColumn オブジェクトの数を減らすことができます。個別の列にエラーを設定するには、SetColumnError メソッドを使用します。処理数をさらに減らすには、GetColumnsInError を呼び出す前に、DataRow クラスの HasErrors プロパティを調べて、DataRow にエラーが含まれるかどうかを確認します。

行のすべてのエラーを消去するには、ClearErrors メソッドを使用します。これには RowError が含まれます。

使用例

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.GetUpperBound(0)
          ' 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
GetColumnError
GetErrors
HasErrors
RowError
SetColumnError