ASP.NET DataGrid 顯示小數位數控制完整指南：SQL 端格式化、繫結端格式化、項目繫結事件三大方案

需求：將 `125 / 60.00 = 2.083333...` 小時在 DataGrid 中僅顯示 `2.08` (保留兩位小數)。本文彙整三大主流解法：**SQL 查詢端格式化**、**DataGrid 繫結屬性格式化**、**ItemDataBound 事件程式化控制**，並比較優劣適用場景。

方案一：SQL 查詢端格式化 (資料庫層處理)

**優點**：資料傳輸量小、前端無需額外處理、報表匯出一致。
**缺點**：精度在資料庫端截失、不同 DB 語法不一、排序/篩選可能受影響。

方案二：DataGrid 繫結欄位 DataFormatString (宣告式、零代碼)

ASPX 標記

<asp:DataGrid ID="DataGrid1" runat="server" AutoGenerateColumns="False">
  <Columns>
    <asp:BoundColumn 
        DataField="Hours" 
        HeaderText="工時" 
        DataFormatString="{0:F2}" 
        HtmlEncode="False" />
    <!-- F2 = 固定兩位小數；N2 = 含千分位分隔符 -->
  </Columns>
</asp:DataGrid>

關鍵屬性

• `DataFormatString="{0:F2}"`：標準 .NET 數值格式字串
• `HtmlEncode="False"`：**必須設為 False**，否則格式化字串會被 HTML 編碼而失效

**常用格式字串**：

方案三：ItemDataBound 事件程式化控制 (最大彈性)

protected void DataGrid1_ItemDataBound(object sender, DataGridItemEventArgs e)
{
    if (e.Item.ItemType == ListItemType.Item || e.Item.ItemType == ListItemType.AlternatingItem)
    {
        // 假設 Hours 在第 2 欄 (索引 1)
        decimal hours = Convert.ToDecimal(DataBinder.Eval(e.Item.DataItem, "Hours"));
        e.Item.Cells[1].Text = hours.ToString("F2"); // 或 N2, C2...
        
        // 進階：依條件動態格式
        if (hours > 100) 
            e.Item.Cells[1].CssClass = "overtime-highlight";
    }
}

**優點**：可依資料值動態決定格式、加 CSS Class、加圖示、甚至改寫整個 Cell 內容。
**缺點**：需寫代碼、效能略低於宣告式、維護成本較高。

方案比較與選擇建議

決策樹

需要在匯出/報表/下游系統保持原始精度？
  ├─ 是 → 勿在 SQL 端截斷，改用 DataFormatString 或 ItemDataBound
  └─ 否 → 
      需要動態條件格式 (如負數紅字、超標高亮)？
        ├─ 是 → ItemDataBound
        └─ 否 → DataFormatString (最簡潔、零代碼、效能佳)

常見坑點提醒

1. 忘記 `HtmlEncode="False"`：格式化後的字串被編碼為 `1234.57` → 顯示失敗
2. 資料類型不匹配：`DataField` 綁定的是 `String` 而非數值型別，格式化無效 → 確保 SQL 回傳 `DECIMAL`/`FLOAT` 或後台 `Convert.ToDecimal`
3. 文化特性影響：`{0:N2}` 千分位符號依 `Thread.CurrentThread.CurrentCulture` (台/美制不同) → 明確設定 `CultureInfo` 或用 `{0:F2}` 避免千分位
4. GridView 相容：`GridView` 同樣支援 `BoundField.DataFormatString` + `HtmlEncode="false"`

現代化對應：Razor / Blazor / 前端格式化

@* Razor Pages / MVC *@
<td>@Model.Hours.ToString("F2")</td>
<td>@String.Format("{0:F2}", Model.Hours)</td>

@* Blazor *@
<td>@hours.ToString("F2")</td>

@* JavaScript (客戶端) *@
cell.textContent = hours.toFixed(2); // 或 toLocaleString(undefined, {minimumFractionDigits: 2})

小數位數控制看似微不足道，卻關係到**資料精度保真、跨層一致性、國際化支援、維護成本**。掌握三大方案優劣，依據「精度保留需求、動態格式化需求、團隊技術棧」三角決策，才能在專案中建立統一、可擴充的格式化規範。