DataGridViewCheckBoxCell 沒有 Checked 屬性,初學者常困惑於 FormattedValue、EditedFormattedValue、Value 的差異。本文透過情境圖解說明三者關係,並提供正確取值模式。
| 屬性 | 型別 | 含義 | 何時更新 |
|---|---|---|---|
| Value | object | 資料來源繫結的底層值 (如 true/false、1/0、Y/N) | CellEndEdit、資料繫結時 |
| FormattedValue | object | 「已確認」的顯示值。使用者離開儲存格後,等同 Value 經格式化結果 | CellEndEdit、CellLeave、RowLeave |
| EditedFormattedValue | object | 「編輯中」的即時值。使用者點選核取方塊瞬間即更新,尚未確認 | CurrentCellDirtyStateChanged、CellValueChanged |
EditedFormattedValue = trueFormattedValue = falseValue = false (或 DBNull)EditedFormattedValue = falseFormattedValue = falseValue = false// 在 CellContentClick、CellValueChanged 或按鈕點擊事件中
foreach (DataGridViewRow row in dataGridView1.Rows)
{
var cell = row.Cells["CheckCol"] as DataGridViewCheckBoxCell;
if (cell == null) continue;
// 取編輯中即時值,若為 null 則 fallback 到已確認值
bool isChecked = (cell.EditedFormattedValue as bool?)
?? (cell.FormattedValue as bool?)
?? (cell.Value as bool?)
?? false;
if (isChecked)
{
// 處理勾選行
}
}
CellFormatting 統一轉換為 bool,或在取值時用 Convert.ToBoolean 處理多種型別。CellContentClick 直接讀 Value 會拿到舊值。解決:在該事件呼叫 dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit) 強制認可。BindingList<T> 或 DataTable,直接操作資料源再 Refresh()。var col = new DataGridViewCheckBoxColumn
{
Name = "Active",
DataPropertyName = "IsActive",
TrueValue = "Y", // 資料庫存 Y/N
FalseValue = "N",
IndeterminateValue = "U" // 可選,三態
};
dataGridView1.Columns.Add(col);
設定後 Value 會自動在 "Y"/"N" 與 bool 互轉,FormattedValue 仍為 bool。