DataGridView.CommitEdit(DataGridViewDataErrorContexts) Methode

Definition

Speichert Änderungen am Datencache in der aktiven Zelle, ohne den Bearbeitungsmodus zu beenden.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

Parameter

context
DataGridViewDataErrorContexts

Eine bitweise Kombination von DataGridViewDataErrorContexts-Werten, die den Kontext angibt, in dem ein Fehler auftreten kann.A bitwise combination of DataGridViewDataErrorContexts values that specifies the context in which an error can occur.

Gibt zurück

true, wenn die Änderungen gespeichert wurden, andernfalls false.true if the changes were committed; otherwise false.

Ausnahmen

Für den Zellwert konnte kein Commit ausgeführt werden, und entweder ist kein Handler für das DataError-Ereignis vorhanden, oder der Handler hat die ThrowException-Eigenschaft auf true festgelegt.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.

Beispiele

Im folgenden Codebeispiel wird die CommitEdit-Methode innerhalb eines CurrentCellDirtyStateChanged-Ereignis Handlers aufgerufen, um das CellValueChanged-Ereignis zu erhöhen.The following code example calls the CommitEdit method within a CurrentCellDirtyStateChanged event handler to raise the CellValueChanged event. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in gewusst wie: Deaktivieren von Schaltflächen in einer Schaltflächen Spalte im Windows Forms DataGridView-Steuerelement.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

Hinweise

Diese Methode versucht, den formatierten benutzerdefinierten Wert in den zugrunde liegenden Zellen Datentyp zu konvertieren.This method attempts to convert the formatted, user-specified value to the underlying cell data type. Zu diesem Zweck wird das Ereignis CellParsing ausgelöst, das Sie behandeln können, um die Typkonvertierung anzupassen.To do this, it raises the CellParsing event, which you can handle to customize the type conversion. Andernfalls werden Standardtyp Konverter verwendet.Otherwise, default type converters are used. Konvertierungs Fehler können zu einer Ausnahme führen, wenn das DataError-Ereignis nicht behandelt wird, um es zu verhindern.Conversion errors may result in an exception if the DataError event is not handled to prevent it. Wenn der Wert erfolgreich konvertiert wird, wird er an den Datenspeicher übertragen. dabei wird das CellValuePushed-Ereignis für nicht Daten gebundene Zellen erhöht, wenn der Wert der Eigenschaft VirtualMode true ist.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. Wenn für den Wert erfolgreich ein Commit ausgeführt wurde, tritt das CellValueChanged-Ereignis auf.If the value is successfully committed, the CellValueChanged event occurs.

Gilt für:

Siehe auch