DataGridView.IsCurrentCellDirty Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient une valeur indiquant si la cellule active comporte des modifications non validées.

public:
 property bool IsCurrentCellDirty { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool IsCurrentCellDirty { get; }

[<System.ComponentModel.Browsable(false)>]
member this.IsCurrentCellDirty : bool

Public ReadOnly Property IsCurrentCellDirty As Boolean

Valeur de propriété

Boolean

true si la cellule active comporte des modifications non validées ; sinon, false.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant utilise la IsCurrentCellDirty propriété pour déterminer s’il faut valider une valeur de cellule et déclencher l’événement CellValueChanged à partir d’un gestionnaire pour l’événement CurrentCellDirtyStateChanged . Cet exemple de code fait partie d’un exemple plus large fourni dans How to: Disable Button Column in a Button Column in the Windows Forms Contrôle DataGridView.

// 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

Lorsque le DataGridView n’est pas lié à des données, la modification de cellule est considérée comme validée lorsque l’utilisateur passe à une autre cellule.

Si les en-têtes de ligne sont visibles, un glyphe de crayon est présent dans l’en-tête de la ligne qui contient une cellule avec des modifications non validées.

Si IsCurrentCellDirty est true et que la cellule active héberge un contrôle d’édition, vous pouvez le récupérer via la EditingControl propriété .

Voir aussi

• DataGridView, contrôle (Windows Forms)