DataGridViewRow.ErrorText プロパティ

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

DataGridViewRow.ErrorText プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

行レベルのエラーのエラー メッセージ テキストを取得または設定します。

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

Visual Basic (宣言)

Public Property ErrorText As
 String

Visual Basic (使用法)

Dim instance As DataGridViewRow
Dim value As String

value = instance.ErrorText

instance.ErrorText = value

C#

public string ErrorText { get;
 set; }

C++

public:
property String^ ErrorText {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_ErrorText ()

/** @property */
public void set_ErrorText (String value)

JScript

public function get ErrorText
 () : String

public function set ErrorText
 (value : String)

プロパティ値
エラー メッセージを含む String。

例外

例外の種類	条件
InvalidOperationException	このプロパティの値の取得時に、行が DataGridView コントロール内の共有行です。

解説

このプロパティを使用して、行レベルのエラーのエラー メッセージを指定します。指定したメッセージは、行ヘッダーに表示されるエラー アイコンの上にマウス ポインタを移動したときに、ツールヒントとして表示されます。

この行が DataGridView コントロールに関連付けられている場合、このプロパティを設定すると RowErrorTextChanged イベントが発生します。

使用例

ErrorText プロパティを DataError イベント ハンドラで使用する方法を、次のコード例に示します。この例は DataGridViewComboBoxColumn クラスの概要で取り上げているコード例の一部です。

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

プラットフォーム

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

参照

関連項目
DataGridViewRow クラス
DataGridViewRow メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewCell.ErrorText プロパティ
DataGridView.DataError イベント
DataGridView.RowErrorTextNeeded イベント
DataGridView.RowErrorTextChanged イベント
ErrorProvider
その他の技術情報
Windows フォーム DataGridView コントロールを拡張するための推奨される手順