`DataGridView.AutoSizeColumnsMode` 決定欄寬如何自動計算,共有 8 種枚舉值。正確選擇可避免「欄寬過窄看不全」、「水平捲軸異常」、「效能下降」等問題。本文詳細說明各模式行為、適用場景與程式碼範例。
八大模式詳細對照
| 枚舉值 | 行為 | 包含標題列 | 計算範圍 | 效能 | 建議場景 |
| AllCells | 符合所有儲存格內容 (含標題) | 是 | 全資料列 | 慢 (大量資料) | 資料筆數少、需完美顯示 |
| AllCellsExceptHeader | 符合所有儲存格內容 (不含標題) | 否 | 全資料列 | 慢 | 標題固定寬度、資料變動大 |
| ColumnHeader | 符合標題文字 | 僅標題 | 標題列 | 極快 | 資料內容極長、不想被撐寬 |
| DisplayedCells | 符合**目前可視範圍**儲存格 (含標題) | 是 | 可視列 | 中 | 大量資料、只看當頁 |
| DisplayedCellsExceptHeader | 符合**目前可視範圍**儲存格 (不含標題) | 否 | 可視列 | 中 | 大量資料、標題固定 |
| Fill | **填滿控制項寬度**,依 `FillWeight` 比例分配 | 否 | 控制項寬度 | 快 | **響應式佈局、無水平捲軸** |
| None | 不自動調整,維持設計時/程式設定寬度 | 否 | — | 最快 | 固定版面、自行控制寬度 |
| NotSet | 繼承 `DataGridView.AutoSizeColumnsMode` 設定 | — | — | — | 欄位層級覆寫時使用 |
Fill 模式實戰:響應式比例欄寬
// 綁定資料後
dataGridView.DataSource = ds.Tables[0];
// 設定整體模式為 Fill
dataGridView.AutoSizeColumnsMode = DataGridViewAutoSizeColumnsMode.Fill;
// 設定各欄相對權重 (總和不需為 100,系統自動正規化)
dataGridView.Columns[0].FillWeight = 10; // 10% - 編號
dataGridView.Columns[1].FillWeight = 20; // 20% - 日期
dataGridView.Columns[2].FillWeight = 30; // 30% - 標題
dataGridView.Columns[3].FillWeight = 40; // 40% - 內容摘要
// 設定最小寬度,防止視窗縮小時內容被擠壓
dataGridView.Columns[0].MinimumWidth = 50;
dataGridView.Columns[1].MinimumWidth = 80;
dataGridView.Columns[2].MinimumWidth = 120;
dataGridView.Columns[3].MinimumWidth = 150;
// 可選:禁止使用者手動調整特定欄
dataGridView.Columns[0].Resizable = DataGridViewTriState.False;
設定標題文字
dataGridView.ColumnHeadersVisible = true;
dataGridView.Columns[0].HeaderText = "編號";
dataGridView.Columns[1].HeaderText = "日期";
dataGridView.Columns[2].HeaderText = "標題";
dataGridView.Columns[3].HeaderText = "摘要";
常見問題與解決
| 問題 | 原因 | 解決 |
| Fill 模式下最後一欄被截斷/有空白 | 捲軸寬度、邊框、DPI 縮放導致計算誤差 | 設定 `dataGridView.ScrollBars = ScrollBars.Vertical`;或最後一欄 `AutoSizeMode = AllCells` |
| 資料繫結後欄寬失效 | `DataSource` 設定後會重置欄屬性 | **先設 DataSource,再設 AutoSizeColumnsMode/FillWeight** |
| 大量資料 (10萬列) 設 AllCells 導致 UI 凍結 | 需遍歷所有列量測文字 | 改用 `DisplayedCells` 或 `Fill`;或虛擬模式 `VirtualMode = true` |
| 中文字體寬度計算不準 | GDI+ MeasureString 與實際繪製有誤差 | 加 `TextRenderer.MeasureText` 或預留 10-20% 餘量 |
WPF / ASP.NET GridView / Blazor 對應
- WPF DataGrid:`Column.Width = new DataGridLength(1, DataGridLengthUnitType.Star)` (相當於 Fill)
- ASP.NET GridView:無直接對應,需 CSS `table-layout: fixed; width: 100%` + ``
- Blazor (MudBlazor/Radzen):`` 或 `ColumnWidth="200px"`
一句話選型:
**響應式佈局、無水平捲軸** → `Fill` + `FillWeight` + `MinimumWidth`
**大量資料、只看當頁** → `DisplayedCellsExceptHeader`
**固定版面、效能優先** → `None` + 手動設定 `Width`