DataGridView.CommitEdit(DataGridViewDataErrorContexts) Yöntem

Tanım

Geçerli hücredeki değişiklikleri düzenleme modunu sonlandırmadan veri önbelleğine işler.

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

Parametreler

context
DataGridViewDataErrorContexts

Hatanın DataGridViewDataErrorContexts oluşabileceği bağlamı belirten bit düzeyinde değerler birleşimi.

Döndürülenler

true değişiklikler işlendiyse; aksi takdirde false.

Özel durumlar

Hücre değeri işlenemedi ve olay için DataError işleyici yok veya işleyici özelliğini olarak ThrowExceptionayarlamıştrue.

Örnekler

Aşağıdaki kod örneği, olayı tetikleyen bir CommitEdit olay işleyicisi CurrentCellDirtyStateChanged içindeki yöntemini çağırırCellValueChanged. Bu kod örneği, Nasıl yapılır: Windows Forms DataGridView Denetimindeki Düğme Sütunundaki Düğmeleri Devre Dışı Bırakma bölümünde sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Bu yöntem, biçimlendirilmiş, kullanıcı tarafından belirtilen değeri temel alınan hücre veri türüne dönüştürmeyi dener. Bunu yapmak için, türü dönüştürmeyi özelleştirmek için işleyebileceğiniz olayı tetikler CellParsing . Aksi takdirde, varsayılan tür dönüştürücüleri kullanılır. Dönüştürme hataları, olayı önlemek için işlenmemesi durumunda DataError bir özel duruma neden olabilir. Değer başarıyla dönüştürülürse, veri deposuna işlenir ve özellik değeri olduğunda CellValuePushedVirtualModeveriye bağlı olmayan hücreler için olayı oluştururtrue. Değer başarıyla işlenirse, CellValueChanged olay gerçekleşir.

Şunlara uygulanır

Ayrıca bkz.