DataGridView.CommitEdit(DataGridViewDataErrorContexts) Méthode

Définition

Valide les modifications dans la cellule active du cache de données sans mettre fin au mode d’édition.

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 de valeurs DataGridViewDataErrorContexts qui spécifie le contexte dans lequel une erreur peut se produire.

Retours

Boolean

true si les modifications ont été validées ; sinon, false.

Exceptions

La valeur de la cellule n’a pas pu être validée, et il n’existe pas de gestionnaire pour l’événement DataError ou le gestionnaire a défini la propriété ThrowException sur true.

Exemples

L’exemple de code suivant appelle la CommitEdit méthode dans un CurrentCellDirtyStateChanged Gestionnaire d’événements pour déclencher l' CellValueChanged événement. cet exemple de code fait partie d’un exemple plus complet fourni dans comment : désactiver des boutons dans une colonne de bouton du contrôle DataGridView Windows Forms.

// 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. Pour ce faire, il déclenche l' CellParsing événement, que vous pouvez gérer pour personnaliser la conversion de type. Dans le cas contraire, les convertisseurs de type par défaut sont utilisés. Les erreurs de conversion peuvent entraîner une exception si l' DataError événement n’est pas géré pour l’empêcher. Si la conversion de la valeur est réussie, elle est validée dans le magasin de données, déclenchant l' CellValuePushed événement pour les cellules non liées aux données lorsque la valeur de la VirtualMode propriété est true . Si la valeur est validée avec succès, l' CellValueChanged événement se produit.

S’applique à

Voir aussi