DataGridView.CommitEdit(DataGridViewDataErrorContexts) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Esegue il commit delle modifiche apportate alla cella corrente nella cache dati senza chiudere la modalità di modifica.

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

Parametri

context
DataGridViewDataErrorContexts

Combinazione bit per bit dei valori di DataGridViewDataErrorContexts che specifica il contesto in cui può verificarsi un errore.

Restituisce

Boolean

true se è stato eseguito il commit delle modifiche; in caso contrario, false.

Eccezioni

Exception

Non è stato possibile sottoporre a commit il valore della cella. Il gestore per l'evento DataError non esiste oppure la proprietà ThrowException del gestore è impostata su true.

Esempio

Nell'esempio di codice seguente viene chiamato il CommitEdit metodo all'interno di un CurrentCellDirtyStateChanged gestore eventi per generare l'evento CellValueChanged . Questo esempio di codice fa parte di un esempio più grande fornito in Procedura: Disabilitare i pulsanti in una colonna button nel controllo 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

Commenti

Questo metodo tenta di convertire il valore formattato e specificato dall'utente nel tipo di dati della cella sottostante. A tale scopo, genera l'evento CellParsing , che è possibile gestire per personalizzare la conversione del tipo. In caso contrario, vengono usati convertitori di tipi predefiniti. Gli errori di conversione possono causare un'eccezione se l'evento DataError non viene gestito per impedirlo. Se il valore viene convertito correttamente, viene eseguito il commit nell'archivio dati, generando l'evento CellValuePushed per celle non associate a dati quando il valore della VirtualMode proprietà è true. Se il valore viene eseguito correttamente il commit, si verifica l'evento CellValueChanged .

Si applica a

Vedi anche