DataGridView.CommitEdit(DataGridViewDataErrorContexts) Méthode

Définition

Valide les modifications dans la cellule active du cache de données sans terminer le mode édition.Commits changes in the current cell to the data cache without ending edit mode.

public:
 bool CommitEdit(System::Windows::Forms::DataGridViewDataErrorContexts context);
public bool CommitEdit (System.Windows.Forms.DataGridViewDataErrorContexts context);
member this.CommitEdit : System.Windows.Forms.DataGridViewDataErrorContexts -> bool
Public Function CommitEdit (context As DataGridViewDataErrorContexts) As Boolean

Paramètres

context
DataGridViewDataErrorContexts

Combinaison d'opérations de bits des valeurs DataGridViewDataErrorContexts qui spécifie le contexte dans lequel une erreur peut se produire.A bitwise combination of DataGridViewDataErrorContexts values that specifies the context in which an error can occur.

Retours

true si les modifications ont été validées ; sinon, false.true if the changes were committed; otherwise false.

Exceptions

La valeur de la cellule n’a pas pu être validée et soit il n’existe aucun gestionnaire pour l’événement DataError, soit le gestionnaire a affecté à la propriété ThrowException la valeur true.The cell value could not be committed and either there is no handler for the DataError event or the handler has set the ThrowException property to true.

Exemples

L’exemple de code suivant appelle la méthode CommitEdit dans un gestionnaire d’événements CurrentCellDirtyStateChanged pour déclencher l’événement CellValueChanged.The following code example calls the CommitEdit method within a CurrentCellDirtyStateChanged event handler to raise the CellValueChanged event. Cet exemple de code fait partie d’un exemple plus complet fourni dans How à : Désactivez les boutons dans une colonne de bouton du contrôle DataGridView Windows Forms.This code example is part of a larger example provided in How to: Disable Buttons in a Button Column in the Windows Forms DataGridView Control.

// This event handler manually raises the CellValueChanged event
// by calling the CommitEdit method.
void dataGridView1_CurrentCellDirtyStateChanged(object sender,
    EventArgs e)
{
    if (dataGridView1.IsCurrentCellDirty)
    {
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
    }
}

// If a check box cell is clicked, this event handler disables  
// or enables the button in the same row as the clicked cell.
public void dataGridView1_CellValueChanged(object sender,
    DataGridViewCellEventArgs e)
{
    if (dataGridView1.Columns[e.ColumnIndex].Name == "CheckBoxes")
    {
        DataGridViewDisableButtonCell buttonCell =
            (DataGridViewDisableButtonCell)dataGridView1.
            Rows[e.RowIndex].Cells["Buttons"];

        DataGridViewCheckBoxCell checkCell =
            (DataGridViewCheckBoxCell)dataGridView1.
            Rows[e.RowIndex].Cells["CheckBoxes"];
        buttonCell.Enabled = !(Boolean)checkCell.Value;

        dataGridView1.Invalidate();
    }
}
' This event handler manually raises the CellValueChanged event
' by calling the CommitEdit method.
Sub dataGridView1_CurrentCellDirtyStateChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles dataGridView1.CurrentCellDirtyStateChanged

    If dataGridView1.IsCurrentCellDirty Then
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit)
    End If
End Sub

' If a check box cell is clicked, this event handler disables  
' or enables the button in the same row as the clicked cell.
Public Sub dataGridView1_CellValueChanged(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellValueChanged

    If dataGridView1.Columns(e.ColumnIndex).Name = "CheckBoxes" Then
        Dim buttonCell As DataGridViewDisableButtonCell = _
            CType(dataGridView1.Rows(e.RowIndex).Cells("Buttons"), _
            DataGridViewDisableButtonCell)

        Dim checkCell As DataGridViewCheckBoxCell = _
            CType(dataGridView1.Rows(e.RowIndex).Cells("CheckBoxes"), _
            DataGridViewCheckBoxCell)
        buttonCell.Enabled = Not CType(checkCell.Value, [Boolean])

        dataGridView1.Invalidate()
    End If
End Sub

Remarques

Cette méthode tente de convertir la valeur mise en forme spécifiée par l’utilisateur au type de données de la cellule sous-jacente.This method attempts to convert the formatted, user-specified value to the underlying cell data type. Pour ce faire, il déclenche l’événement CellParsing, que vous pouvez gérer pour personnaliser la conversion de type.To do this, it raises the CellParsing event, which you can handle to customize the type conversion. Dans le cas contraire, les convertisseurs de type par défaut sont utilisés.Otherwise, default type converters are used. Les erreurs de conversion peuvent entraîner une exception si l’événement DataError n’est pas géré pour l’empêcher.Conversion errors may result in an exception if the DataError event is not handled to prevent it. Si la conversion de la valeur est réussie, elle est validée dans le magasin de données, déclenchant l’événement CellValuePushed pour les cellules non liées aux données lorsque la valeur de la propriété VirtualMode est true.If the value is successfully converted, it is committed to the data store, raising the CellValuePushed event for non-data-bound cells when the VirtualMode property value is true. Si la valeur est validée avec succès, l’événement CellValueChanged se produit.If the value is successfully committed, the CellValueChanged event occurs.

S’applique à

Voir aussi