DataGridViewDataErrorEventArgs Classe

Définition

Fournit des données pour l'événement DataError.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
Héritage

Exemples

L’exemple de code suivant montre comment répondre aux informations fournies par la classe DataGridViewDataErrorEventArgs.The following code example demonstrates how to respond to information provided by the DataGridViewDataErrorEventArgs class. Cet exemple fait partie d’un exemple plus complet disponible dans la rubrique vue d’ensemble de la classe DataGridViewComboBoxColumn.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

Remarques

La gestion de l’événement DataError vous permet de gérer les exceptions levées par du code en dehors de votre contrôle (par exemple, par une source de données externe).Handling the DataError event lets you handle exceptions thrown by code outside your control (for example, by an external data source). Utilisez la propriété Context pour déterminer l’état du DataGridView au moment de l’exception.Use the Context property to determine the state of the DataGridView at the time of the exception. Utilisez la propriété Exception pour récupérer les données d’exception.Use the Exception property to retrieve the exception data. Si vous souhaitez gérer l’exception par d’autres gestionnaires d’événements, affectez à la propriété ThrowException la valeur true.If you want to handle the exception by additional event handlers, set the ThrowException property to true.

Les propriétés ColumnIndex et RowIndex indiquent normalement la cellule dans laquelle l’erreur de données s’est produite.The ColumnIndex and RowIndex properties normally indicate the cell in which the data error occurred. Toutefois, lorsque l’erreur se produit dans une source de données externe, la source de données peut ne pas fournir la colonne dans laquelle l’erreur s’est produite.When the error occurs in an external data source, however, the data source may not provide the column in which the error occurred. Dans ce cas, la propriété ColumnIndex indique généralement la colonne de la cellule active au moment de l’erreur.In this case, the ColumnIndex property typically indicates the column of the current cell at the time of the error.

Constructeurs

DataGridViewDataErrorEventArgs(Exception, Int32, Int32, DataGridViewDataErrorContexts)

Initialise une nouvelle instance de la classe DataGridViewDataErrorEventArgs.Initializes a new instance of the DataGridViewDataErrorEventArgs class.

Propriétés

Cancel

Obtient ou définit une valeur indiquant si l'événement doit être annulé.Gets or sets a value indicating whether the event should be canceled.

(Hérité de CancelEventArgs)
ColumnIndex

Obtient l'index de colonne de la cellule sur laquelle l'événement se produit.Gets the column index of the cell that the event occurs for.

(Hérité de DataGridViewCellCancelEventArgs)
Context

Obtient des informations sur l'état de DataGridView lorsque l'erreur s'est produite.Gets details about the state of the DataGridView when the error occurred.

Exception

Obtient l'exception qui représente l'erreur.Gets the exception that represents the error.

RowIndex

Obtient l'index de ligne de la cellule sur laquelle l'événement se produit.Gets the row index of the cell that the event occurs for.

(Hérité de DataGridViewCellCancelEventArgs)
ThrowException

Obtient ou définit une valeur indiquant s'il faut lever l'exception une fois que le délégué DataGridViewDataErrorEventHandler a fini de la traiter.Gets or sets a value indicating whether to throw the exception after the DataGridViewDataErrorEventHandler delegate is finished with it.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi