Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Développer Réduire

DataGridView.CommitEdit, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

Valide les modifications dans la cellule active du cache de données sans terminer le mode édition.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public bool CommitEdit (
	DataGridViewDataErrorContexts context
)
public boolean CommitEdit (
	DataGridViewDataErrorContexts context
)
public function CommitEdit (
	context : DataGridViewDataErrorContexts
) : boolean

Paramètres

context

Une combinaison d'opérations de bits des valeurs DataGridViewDataErrorContexts qui spécifient le contexte dans lequel une erreur peut se produire.

Valeur de retour

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

Type d'exceptionCondition

Exception

La valeur de la cellule n'a pas pu être validée et soit il n'y a aucun gestionnaire pour l'événement DataError, soit le gestionnaire a affecté la valeur true à la propriété DataGridViewDataErrorEventArgs.ThrowException.

Cette méthode tente de convertir la valeur mise en forme spécifiée par l'utilisateur dans le type de données de cellule sous-jacent. Pour faire ceci, il déclenche l'événement CellParsing que vous pouvez gérer pour personnaliser la conversion de type. Sinon, les convertisseurs de type par défaut sont utilisés. Les erreurs de conversion peuvent être à l'origine d'une exception si l'événement DataError 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, en déclenchant l'événement CellValuePushed pour les cellules non liées aux données lorsque la valeur de propriété VirtualMode est true. Si la validation de la valeur est réussie, l'événement CellValueChanged se produit.

L'exemple de code suivant appelle la méthode CommitEdit dans un gestionnaire d'événements CurrentCellDirtyStateChanged pour déclencher l'événement CellValueChanged. Cet exemple de code fait partie d'un exemple plus développé fourni dans Comment : désactiver des boutons d'une colonne de boutons dans le 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();
    }
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft