DataGridView.CommitEdit(DataGridViewDataErrorContexts) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menerapkan perubahan dalam sel saat ini ke cache data tanpa mengakhiri mode edit.
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
Kombinasi DataGridViewDataErrorContexts nilai bitwise yang menentukan konteks di mana kesalahan dapat terjadi.
Mengembalikan
true
jika perubahan diterapkan; jika tidak false
.
Pengecualian
Nilai sel tidak dapat diterapkan dan tidak ada handler untuk DataError peristiwa atau handler telah mengatur properti ke ThrowExceptiontrue
.
Contoh
Contoh kode berikut memanggil CommitEdit metode dalam CurrentCellDirtyStateChanged penanganan aktivitas untuk menaikkan CellValueChanged peristiwa. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan dalam Cara: Menonaktifkan Tombol di Kolom Tombol di Formulir Windows Kontrol DataGridView.
// 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
Keterangan
Metode ini mencoba mengonversi nilai yang diformat dan ditentukan pengguna ke jenis data sel yang mendasar. Untuk melakukan ini, ini meningkatkan CellParsing peristiwa, yang dapat Anda tangani untuk menyesuaikan konversi jenis. Jika tidak, konverter jenis default digunakan. Kesalahan konversi dapat mengakibatkan pengecualian jika DataError peristiwa tidak ditangani untuk mencegahnya. Jika nilai berhasil dikonversi, nilai tersebut diterapkan ke penyimpanan data, meningkatkan CellValuePushed peristiwa untuk sel yang tidak terikat data saat VirtualMode nilai properti adalah true
. Jika nilai berhasil diterapkan, CellValueChanged peristiwa akan terjadi.