萬盛學電腦網

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

ASP.NET 匯出 Excel/CSV 避免科學記號與長數字截斷完整解決方案

前言

匯出 Excel 時,長數字(身分證字號、信用卡號、手機號)常被 Excel 自動轉為科學記號(如 1.23E+17)或截斷尾數。本文整理三種解決方案,從最簡單的字串前綴到註冊表調整與連接字串參數,適用不同場景。

問題重現

資料:330102199001011234(18 碼身分證)
Excel 顯示:3.30102E+17 或 330102199001011000(尾數歸零)

方案一:字串前綴單引號(最簡單、相容性最佳)

// 在數值前加單引號,Excel 視為純文字
sheet.Cells[row, col] = "'" + longValue.ToString(); 
// 結果:'330102199001011234  →  儲存格顯示 330102199001011234(左對齊,標記為文字)
  • 優點:無需修改 Excel 設定、支援所有版本、CSV/HTML 表格同樣有效。
  • 缺點:資料帶有單引號,若後續需數值運算需先移除。

方案二:設定儲存格格式為文字(NPOI/EPPlus/OpenXML)

// NPOI 範例
var cell = row.CreateCell(col);
cell.SetCellValue(longValue.ToString());
cell.CellStyle = workbook.CreateCellStyle();
cell.CellStyle.DataFormat = HSSFDataFormat.GetBuiltinFormat("@"); // "@" 代表文字格式
// EPPlus 範例
ws.Cells[row, col].Style.Numberformat.Format = "@";
ws.Cells[row, col].Value = longValue.ToString();
  • 優點:真正的文字格式,無單引號殘留,專業報表適用。
  • 缺點:需引入第三方庫(NPOI/EPPlus/ClosedXML),不支援舊版 Microsoft.Office.Interop.Excel。

方案三:調整 OLE DB 連接字串與註冊表(僅適用舊版 Interop/Jet/OLEDB 讀取)

若使用 Microsoft.Jet.OLEDB.4.0 或 Microsoft.ACE.OLEDB.12.0 讀取 Excel:

// 連接字串加入 IMEX=1(混合類型當文字讀取)
var connStr = @"Provider=Microsoft.ACE.OLEDB.12.0;Data Source=file.xlsx;Extended Properties='Excel 12.0 Xml;HDR=YES;IMEX=1;'";

註冊表調整(影響全機器):

路徑:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Jet\4.0\Engines\Excel
值:TypeGuessRows = 0          (掃描所有列決定類型,0=全掃)
     ImportMixedTypes = Text   (混合類型強制當文字)
  • 注意:IMEX=1 只讀模式,無法寫入。
  • 修改註冊表影響所有使用 Jet/ACE 的應用程式,生產環境謹慎操作。

方案比較與選型建議

方案適用匯出庫優點缺點推薦度
單引號前綴Interop、NPOI、EPPlus、HTML Table、CSV零依賴、最簡單資料帶單引號★★★★☆
設定儲存格文字格式NPOI、EPPlus、ClosedXML、OpenXML純淨資料、專業需第三方庫★★★★★
IMEX=1 + 註冊表OLEDB 讀取舊檔解決讀取端問題全機器影響、唯讀★★☆☆☆

現代化建議:棄用 Interop,改用純 .NET 庫

  • EPPlus(商業授權) / ClosedXML(MIT) / NPOI(Apache 2.0):無需安裝 Office、支援 .NET Core/5+/Linux/Docker、效能優異。
  • CSV 匯出:直接 StringBuilder 組裝,長數字欄位加雙引號包裹 \"330102199001011234\",Excel 開啟同樣保持完整。

結語

匯出 Excel 遇到長數字問題,**首選 EPPlus/ClosedXML 設定儲存格格式為文字(@)**,最乾淨專業;若受限於舊系統只能用 Interop 或 HTML Table,**單引號前綴法** 最快落地。徹底移除伺服器端 Office Interop 依賴,是長遠架構正確方向。

copyright © 萬盛學電腦網 all rights reserved