DataGridView.CommitEdit(DataGridViewDataErrorContexts) Método

Definición

Confirma los cambios realizados a la celda actual en la caché de datos sin salir del modo de edición.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

Parámetros

context
DataGridViewDataErrorContexts

Combinación bit a bit de los valores de DataGridViewDataErrorContexts que especifica el contexto en el que se puede producir un error.A bitwise combination of DataGridViewDataErrorContexts values that specifies the context in which an error can occur.

Devoluciones

Es true si se confirmaron los cambios; en caso contrario, es false.true if the changes were committed; otherwise false.

Excepciones

No se pudo confirmar el valor de la celda y no hay ningún controlador para el evento DataError o el controlador ha establecido la propiedad ThrowException en true.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.

Ejemplos

En el ejemplo de código siguiente se llama al método CommitEdit dentro de un controlador de eventos CurrentCellDirtyStateChanged para generar el evento CellValueChanged.The following code example calls the CommitEdit method within a CurrentCellDirtyStateChanged event handler to raise the CellValueChanged event. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en [How para: Deshabilitar botones en una columna de botón en el control DataGridView Windows Forms @ no__t-0.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

Comentarios

Este método intenta convertir el valor especificado por el usuario con formato en el tipo de datos de la celda subyacente.This method attempts to convert the formatted, user-specified value to the underlying cell data type. Para ello, genera el evento CellParsing, que se puede controlar para personalizar la conversión de tipos.To do this, it raises the CellParsing event, which you can handle to customize the type conversion. De lo contrario, se utilizan convertidores de tipos predeterminados.Otherwise, default type converters are used. Los errores de conversión pueden producir una excepción si no se controla el evento DataError para evitarlo.Conversion errors may result in an exception if the DataError event is not handled to prevent it. Si el valor se convierte correctamente, se confirma en el almacén de datos, lo que genera el evento CellValuePushed para las celdas no enlazadas a datos cuando el valor de la propiedad VirtualMode es true.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. Si el valor se confirma correctamente, se produce el evento CellValueChanged.If the value is successfully committed, the CellValueChanged event occurs.

Se aplica a

Consulte también: