萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

DataGridViewCheckBoxCell 深度解析:FormattedValue vs EditedFormattedValue

前言

DataGridViewCheckBoxCell 沒有 Checked 屬性,初學者常困惑於 FormattedValue、EditedFormattedValue、Value 的差異。本文透過情境圖解說明三者關係,並提供正確取值模式。

三大屬性關係圖解

屬性型別含義何時更新
Valueobject資料來源繫結的底層值 (如 true/false、1/0、Y/N)CellEndEdit、資料繫結時
FormattedValueobject「已確認」的顯示值。使用者離開儲存格後,等同 Value 經格式化結果CellEndEdit、CellLeave、RowLeave
EditedFormattedValueobject「編輯中」的即時值。使用者點選核取方塊瞬間即更新,尚未確認CurrentCellDirtyStateChanged、CellValueChanged

情境模擬

情境 A:初始未勾選 → 使用者點一下 (勾選) → 尚未離開儲存格

  • EditedFormattedValue = true
  • FormattedValue = false
  • Value = false (或 DBNull)

情境 B:初始勾選 → 使用者點一下 (取消) → 點選其他儲存格 (確認)

  • EditedFormattedValue = false
  • FormattedValue = false
  • Value = 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)
    {
        // 處理勾選行
    }
}

常見坑點與對策

  1. Value 型別不一致:資料庫可能是 bit (bool)、int (0/1)、char (Y/N)。建議在 CellFormatting 統一轉換為 bool,或在取值時用 Convert.ToBoolean 處理多種型別。
  2. 編輯模式未結束無法取值:若在 CellContentClick 直接讀 Value 會拿到舊值。解決:在該事件呼叫 dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit) 強制認可。
  3. 大量列效能:逐列迴圈讀取較慢,大量資料建議繫結 BindingList<T> 或 DataTable,直接操作資料源再 Refresh()。

自訂 True/False 值

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。

copyright © 萬盛學電腦網 all rights reserved