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

定義

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

public:
 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.

イベントDataErrorハンドラーでErrorTextプロパティを使用する方法を次のコード例に示します。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.

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

注釈

行レベルのエラーのエラーメッセージを表示するには、このプロパティを使用します。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 以降では、app.config ファイルに次のエントリが含まれている場合に、システムの DPI 設定に従ってエラーアイコンのサイズが変更されます。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:

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

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

適用対象

こちらもご覧ください