DataGridViewDataErrorEventArgs クラス

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

DataGridViewDataErrorEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

DataError イベントのデータを提供します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class DataGridViewDataErrorEventArgs
    Inherits DataGridViewCellCancelEventArgs

Visual Basic (使用法)

Dim instance As DataGridViewDataErrorEventArgs

C#

public class DataGridViewDataErrorEventArgs
 : DataGridViewCellCancelEventArgs

C++

public ref class DataGridViewDataErrorEventArgs
 : public DataGridViewCellCancelEventArgs

J#

public class DataGridViewDataErrorEventArgs
 extends DataGridViewCellCancelEventArgs

JScript

public class DataGridViewDataErrorEventArgs
 extends DataGridViewCellCancelEventArgs

解説

DataError イベントを使用すると、コントロール外のコード (外部データ ソースなど) によりスローされた例外を処理できます。Context プロパティを使用して、例外が発生したときの DataGridView の状態を調べます。Exception プロパティを使用して、例外データを取得します。追加のイベント ハンドラを使用して例外を処理するには、ThrowException プロパティを true に設定します。

使用例

DataGridViewDataErrorEventArgs クラスにより得られた情報に応答する方法を次のコード例に示します。

Visual Basic

Private Sub DataGridView1_DataError(ByVal
 sender As Object, _
ByVal e As DataGridViewDataErrorEventArgs)
 _
Handles DataGridView1.DataError

    MessageBox.Show("Error happened " _
        & e.Context.ToString())

    If (e.Context = DataGridViewDataErrorContexts.Commit) _
        Then
        MessageBox.Show("Commit error")
    End If
    If (e.Context = DataGridViewDataErrorContexts _
        .CurrentCellChange) Then
        MessageBox.Show("Cell change")
    End If
    If (e.Context = DataGridViewDataErrorContexts.Parsing) _
        Then
        MessageBox.Show("parsing error")
    End If
    If (e.Context = _
        DataGridViewDataErrorContexts.LeaveControl) Then
        MessageBox.Show("leave control error")
    End If

    If (TypeOf (e.Exception) Is
 ConstraintException) Then
        Dim view As DataGridView = CType(sender,
 DataGridView)
        view.Rows(e.RowIndex).ErrorText = "an error"
        view.Rows(e.RowIndex).Cells(e.ColumnIndex) _
            .ErrorText = "an error"

        e.ThrowException = False
    End If
End Sub

C#

private void DataGridView1_DataError(object
 sender, DataGridViewDataErrorEventArgs anError)
{

    MessageBox.Show("Error happened " + anError.Context.ToString());

    if (anError.Context == DataGridViewDataErrorContexts.Commit)
    {
        MessageBox.Show("Commit error");
    }
    if (anError.Context == DataGridViewDataErrorContexts.CurrentCellChange)
    {
        MessageBox.Show("Cell change");
    }
    if (anError.Context == DataGridViewDataErrorContexts.Parsing)
    {
        MessageBox.Show("parsing error");
    }
    if (anError.Context == DataGridViewDataErrorContexts.LeaveControl)
    {
        MessageBox.Show("leave control error");
    }

    if ((anError.Exception) is ConstraintException)
    {
        DataGridView view = (DataGridView)sender;
        view.Rows[anError.RowIndex].ErrorText = "an error";
        view.Rows[anError.RowIndex].Cells[anError.ColumnIndex].ErrorText = "an
 error";

        anError.ThrowException = false;
    }
}

C++

private:
    void DataGridView1_DataError(Object^ sender, DataGridViewDataErrorEventArgs^
 anError)
    {

        MessageBox::Show("Error happened " + anError->Context.ToString());

        if (anError->Context == DataGridViewDataErrorContexts::Commit)
        {
            MessageBox::Show("Commit error");
        }
        if (anError->Context == DataGridViewDataErrorContexts::CurrentCellChange)
        {
            MessageBox::Show("Cell change");
        }
        if (anError->Context == DataGridViewDataErrorContexts::Parsing)
        {
            MessageBox::Show("parsing error");
        }
        if (anError->Context == DataGridViewDataErrorContexts::LeaveControl)
        {
            MessageBox::Show("leave control error");
        }

        if (dynamic_cast<ConstraintException^>(anError->Exception)
 != nullptr)
        {
            DataGridView^ view = (DataGridView^)sender;
            view->Rows[anError->RowIndex]->ErrorText = "an error";
            view->Rows[anError->RowIndex]->Cells[anError->ColumnIndex]->ErrorText
 = "an error";

            anError->ThrowException = false;
        }
    }

継承階層

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
       System.Windows.Forms.DataGridViewCellCancelEventArgs
        System.Windows.Forms.DataGridViewDataErrorEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
DataGridViewDataErrorEventArgs メンバ
System.Windows.Forms 名前空間