C# 連接 Excel (OleDb) 完整指南：連線字串、資料讀寫、常見錯誤與效能優化

連線字串對照表

基本讀取範例

using System;
using System.Data;
using System.Data.OleDb;

public class ExcelReader
{
    public DataTable ReadSheet(string filePath, string sheetName = "Sheet1")
    {
        // 自動偵測 Provider (需機器安裝 ACE 12.0 或更新版本)
        string connStr = $@"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filePath};Extended Properties='Excel 12.0;HDR=YES;IMEX=1';";

        using (var conn = new OleDbConnection(connStr))
        {
            conn.Open();
            // 取得實際工作表名稱 (避免 Sheet1$ 不存在)
            var schema = conn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, null);
            string actualSheet = sheetName + "$";
            if (schema != null && !schema.Rows.Cast<DataRow>().Any(r => r["TABLE_NAME"].ToString().Equals(actualSheet, StringComparison.OrdinalIgnoreCase)))
            {
                actualSheet = schema.Rows[0]["TABLE_NAME"].ToString(); // 使用第一個工作表
            }

            string query = $"SELECT * FROM [{actualSheet}]";
            using (var adapter = new OleDbDataAdapter(query, conn))
            {
                var dt = new DataTable();
                adapter.Fill(dt);
                return dt;
            }
        }
    }
}

關鍵參數解析

• HDR=YES：第一列為標題，欄位名稱取自第一列；HDR=NO 則自動命名 F1, F2...。
• IMEX=1：混合模式，強制將欄位視為文字讀取，避免「數字欄位前幾列為數值，後面出現文字導致讀成 null」的經典問題。
• ReadOnly=True：唯讀開啟，避免鎖定檔案，適合多人共用或僅讀取場景。

寫入/更新資料

public void UpdateCell(string filePath, string sheetName, string cellAddress, object value)
{
    // 例: cellAddress = "A1" 或 "R1C1"
    string connStr = $@"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filePath};Extended Properties='Excel 12.0;HDR=NO;';";
    using (var conn = new OleDbConnection(connStr))
    {
        conn.Open();
        // OleDb 不支援直接 UPDATE 儲存格，需透過 OleDbCommand 執行 SQL
        // 注意：Excel SQL 支援有限，建議改用 EPPlus/ClosedXML/NPOI 進行儲存格級操作
        string sql = $"UPDATE [{sheetName}$] SET F1 = ? WHERE F1 = 'TargetKey'"; // 範例
        using (var cmd = new OleDbCommand(sql, conn))
        {
            cmd.Parameters.AddWithValue("@val", value);
            cmd.ExecuteNonQuery();
        }
    }
}

常見錯誤與解決方案

效能優化建議

1. 僅讀取必要欄位：SELECT Col1, Col3 FROM [Sheet$] 而非 SELECT *。
2. 分頁讀取大量資料：OleDb 不支援 LIMIT/OFFSET，需在記憶體中過濾或改用 EPPlus 串流讀取。
3. 批次寫入：OleDb 寫入極慢，大量資料請改用 EPPlus、ClosedXML、NPOI 純 .NET 程式庫，不需安裝 Office/ACE，效能優 10-100 倍。
4. 連線池：OleDb 不支援連線池，頻繁開關連線開銷大，建議單次作業開啟一次連線完成所有操作。

現代替代庫推薦 (無需安裝 Office/ACE)

結語

OleDb 是舊專案相容的選擇，新專案**強烈建議直接使用 EPPlus/ClosedXML/NPOI**，擺脫驅動程式相容性地獄，獲得更好效能、更豐富功能與跨平台能力。