Freigeben über

DataGridViewRow.ErrorText Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DataGridViewRow.cs
Quelle:
DataGridViewRow.cs
Quelle:
DataGridViewRow.cs
Quelle:
DataGridViewRow.cs
Quelle:
DataGridViewRow.cs

Dient zum Abrufen oder Festlegen des Fehlermeldungstexts für Fehler auf Zeilenebene.

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

Eigenschaftswert

String

A String containing the error message.

Ausnahmen

InvalidOperationException

Beim Abrufen des Werts dieser Eigenschaft ist die Zeile eine freigegebene Zeile in einem DataGridView Steuerelement.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ErrorText Eigenschaft in einem DataError Ereignishandler veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das in der DataGridViewComboBoxColumn Klassenübersicht verfügbar ist.

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

Hinweise

Verwenden Sie diese Eigenschaft, um eine Fehlermeldung für Fehler auf Zeilenebene bereitzustellen. Die angegebene Meldung wird in einer QuickInfo angezeigt, wenn der Benutzer den Mauszeiger über das fehlersymbol bewegt, das in der Zeilenkopfzeile angezeigt wird.

Ab .NET Framework 4.5.2 wird die Größe des Fehlersymbols entsprechend der System-DPI-Einstellung geändert, wenn die app.config Datei den folgenden Eintrag enthält:

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

Wenn diese Zeile einem DataGridView Steuerelement zugeordnet ist, löst das Festlegen dieser Eigenschaft das RowErrorTextChanged Ereignis aus.

Gilt für:

Weitere Informationen