DataGridViewDataErrorEventArgs Klasse

Definition

Stellt Daten für das DataError-Ereignis bereit.Provides data for the DataError event.

public ref class DataGridViewDataErrorEventArgs : System::Windows::Forms::DataGridViewCellCancelEventArgs
public class DataGridViewDataErrorEventArgs : System.Windows.Forms.DataGridViewCellCancelEventArgs
type DataGridViewDataErrorEventArgs = class
    inherit DataGridViewCellCancelEventArgs
Public Class DataGridViewDataErrorEventArgs
Inherits DataGridViewCellCancelEventArgs
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie auf die von der DataGridViewDataErrorEventArgs -Klasse bereitgestellten Informationen reagiert wird.The following code example demonstrates how to respond to information provided by the DataGridViewDataErrorEventArgs class. Dieses Beispiel ist Teil eines größeren Beispiels, das im Thema DataGridViewComboBoxColumn Übersicht über die Klasse verfügbar ist.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

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

Wenn Sie DataError das-Ereignis behandeln, können Sie Ausnahmen behandeln, die von Code außerhalb ihrer Kontrolle ausgelöst werden (z. b. durch eine externe Datenquelle).Handling the DataError event lets you handle exceptions thrown by code outside your control (for example, by an external data source). Verwenden Sie Context die-Eigenschaft, um den Zustand DataGridView der zum Zeitpunkt der Ausnahme zu bestimmen.Use the Context property to determine the state of the DataGridView at the time of the exception. Verwenden Sie Exception die-Eigenschaft, um die Ausnahme Daten abzurufen.Use the Exception property to retrieve the exception data. Wenn Sie die Ausnahme von zusätzlichen Ereignis Handlern behandeln möchten, legen Sie die ThrowException -Eigenschaft trueauf fest.If you want to handle the exception by additional event handlers, set the ThrowException property to true.

Die ColumnIndex Eigenschaften RowIndex und geben normalerweise die Zelle an, in der der Datenfehler aufgetreten ist.The ColumnIndex and RowIndex properties normally indicate the cell in which the data error occurred. Wenn der Fehler in einer externen Datenquelle auftritt, stellt die Datenquelle jedoch möglicherweise nicht die Spalte bereit, in der der Fehler aufgetreten ist.When the error occurs in an external data source, however, the data source may not provide the column in which the error occurred. In diesem Fall gibt die ColumnIndex -Eigenschaft in der Regel die Spalte der aktuellen Zelle zum Zeitpunkt des Fehlers an.In this case, the ColumnIndex property typically indicates the column of the current cell at the time of the error.

Konstruktoren

DataGridViewDataErrorEventArgs(Exception, Int32, Int32, DataGridViewDataErrorContexts)

Initialisiert eine neue Instanz der DataGridViewDataErrorEventArgs-Klasse.Initializes a new instance of the DataGridViewDataErrorEventArgs class.

Eigenschaften

Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

(Geerbt von CancelEventArgs)
ColumnIndex

Ruft den Spaltenindex der Zelle ab, für die das Ereignis eintritt.Gets the column index of the cell that the event occurs for.

(Geerbt von DataGridViewCellCancelEventArgs)
Context

Ruft Details über den Zustand ab, in dem sich die DataGridView beim Auftreten des Fehlers befand.Gets details about the state of the DataGridView when the error occurred.

Exception

Ruft die Ausnahme ab, die den Fehler darstellt.Gets the exception that represents the error.

RowIndex

Ruft den Zeilenindex der Zelle ab, für die das Ereignis eintritt.Gets the row index of the cell that the event occurs for.

(Geerbt von DataGridViewCellCancelEventArgs)
ThrowException

Ruft einen Wert ab, der angibt, ob die die Ausnahme ausgelöst werden soll, nachdem der DataGridViewDataErrorEventHandler-Delegat seine Aktion beendet hat, oder legt diesen fest.Gets or sets a value indicating whether to throw the exception after the DataGridViewDataErrorEventHandler delegate is finished with it.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch