DataGridView.CommitEdit(DataGridViewDataErrorContexts) Metoda

Definicja

Zatwierdza zmiany w bieżącej komórce do pamięci podręcznej danych bez kończenia trybu edycji.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

Parametry

context
DataGridViewDataErrorContexts

Bitowa kombinacja DataGridViewDataErrorContexts wartości, która określa kontekst, w którym może wystąpić błąd.A bitwise combination of DataGridViewDataErrorContexts values that specifies the context in which an error can occur.

Zwraca

Boolean

true Jeśli zmiany zostały zatwierdzone; w przeciwnym razie false .true if the changes were committed; otherwise false.

Wyjątki

Nie można zatwierdzić wartości komórki, a dla zdarzenia nie istnieje procedura obsługi DataError lub jej właściwość została ustawiona na wartość ThrowException 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.

Przykłady

Poniższy przykład kodu wywołuje CommitEdit metodę w ramach CurrentCellDirtyStateChanged procedury obsługi zdarzeń w celu podniesienia CellValueChanged zdarzenia.The following code example calls the CommitEdit method within a CurrentCellDirtyStateChanged event handler to raise the CellValueChanged event. Ten przykład kodu jest częścią większego przykładu podanego w instrukcje: wyłączanie przycisków w kolumnie przycisków w kontrolce DataGridView Windows Forms.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

Uwagi

Ta metoda próbuje skonwertować sformatowaną wartość określoną przez użytkownika na typ danych komórki bazowej.This method attempts to convert the formatted, user-specified value to the underlying cell data type. W tym celu wywołuje CellParsing zdarzenie, które można obsłużyć, aby dostosować konwersję typu.To do this, it raises the CellParsing event, which you can handle to customize the type conversion. W przeciwnym razie używane są domyślne konwertery typów.Otherwise, default type converters are used. Błędy konwersji mogą spowodować wyjątek, jeśli DataError zdarzenie nie zostało obsłużone w celu uniemożliwienia tego.Conversion errors may result in an exception if the DataError event is not handled to prevent it. Jeśli wartość zostanie pomyślnie przekonwertowana, jest ona zatwierdzona dla magazynu danych, co powoduje podnoszenie poziomu CellValuePushed zdarzenia dla komórek niezwiązanych z danymi, gdy VirtualMode wartość właściwości jest 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. Jeśli wartość zostanie pomyślnie zatwierdzona, CellValueChanged wystąpi zdarzenie.If the value is successfully committed, the CellValueChanged event occurs.

Dotyczy

Zobacz też