DataGridViewRow.ErrorText Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft den Fehlermeldungstext für Fehler auf Zeilenebene ab oder legt diesen fest.

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

Ein String-Wert, der die Fehlermeldung enthält.

Ausnahmen

InvalidOperationException

Beim Abrufen des Werts dieser Eigenschaft stellt die Zeile eine freigegebene Zeile in einem DataGridView-Steuerelement dar.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ErrorText -Eigenschaft in einem DataError Ereignishandler verwendet wird. 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 im Zeilenkopf angezeigte Fehlersymbol bewegt.

Ab dem .NET Framework 4.5.2 wird die Größe des Fehlersymbols entsprechend der Dpi-Einstellung des Systems geändert, wenn die datei app.config 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