DataGridViewRow.ErrorText DataGridViewRow.ErrorText DataGridViewRow.ErrorText DataGridViewRow.ErrorText Property


行レベルのエラーのエラー メッセージ テキストを取得または設定します。Gets or sets the error message text for row-level errors.

 property System::String ^ ErrorText { System::String ^ get(); void set(System::String ^ value); };
public string ErrorText { get; set; }
member this.ErrorText : string with get, set
Public Property ErrorText As String


エラー メッセージを含む StringA String containing the error message.


このプロパティの値の取得時に、行が DataGridView コントロール内の共有行です。When getting the value of this property, the row is a shared row in a DataGridView control.

次のコード例は、使用する方法を示します、ErrorTextプロパティ、DataErrorイベント ハンドラー。The following code example demonstrates how to use the ErrorText property in a DataError event handler. この例は例で使用できる、DataGridViewComboBoxColumnクラスの概要。This example is part of a larger example available in the DataGridViewComboBoxColumn class overview.

    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;
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;
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) _
        MessageBox.Show("Commit error")
    End If
    If (e.Context = DataGridViewDataErrorContexts _
        .CurrentCellChange) Then
        MessageBox.Show("Cell change")
    End If
    If (e.Context = DataGridViewDataErrorContexts.Parsing) _
        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


このプロパティを使用して、行レベルのエラーのエラー メッセージを提供します。Use this property to provide an error message for row-level errors. 指定したメッセージは、行ヘッダーに表示されるエラー アイコンの上にマウス ポインターを動かしたときに、ツールヒントに表示されます。The specified message is displayed in a ToolTip when the user moves the mouse pointer over the error icon shown in the row header.

以降、.NET Framework 4.5.2 では、エラー アイコン サイズが変更されたシステム DPI 設定に従って、app.config ファイルには、次のエントリが含まれている場合。Starting with the .NET Framework 4.5.2, the error icon is resized according to the system DPI setting when the app.config file contains the following entry:

  <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />  

この行が関連付けられている場合、DataGridViewコントロールは、このプロパティの設定が発生、RowErrorTextChangedイベント。If this row is associated with a DataGridView control, setting this property will raise the RowErrorTextChanged event.