萬盛學電腦網

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

ASP.NET 上傳並讀取 Excel 檔案完整範例:OleDb 連線與 DataGrid 繫結

前言

透過 FileUpload 控制項上傳 Excel 檔,再以 OleDb 連線讀取工作表資料繫結至 GridView,是經典 WebForm 匯入功能。本文提供完整可執行範例,並說明連接字串參數、權限設定與常見坑點。

前端頁面

<%@ Page Language="C#" %>
<form id="form1" runat="server" enctype="multipart/form-data">
    <asp:FileUpload ID="FileUpload1" runat="server" />
    <asp:Button ID="btnImport" runat="server" Text="匯入" OnClick="btnImport_Click" />
    <asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true" />
    <asp:Label ID="lblMsg" runat="server" ForeColor="Red" />
</form>

後端程式碼

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

protected void btnImport_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile)
    {
        lblMsg.Text = "請選擇檔案";
        return;
    }

    // 1. 儲存暫存檔(避免佔用原檔、支援同名覆蓋)
    string ext = Path.GetExtension(FileUpload1.FileName).ToLower();
    if (ext != ".xls" && ext != ".xlsx")
    {
        lblMsg.Text = "僅支援 .xls / .xlsx";
        return;
    }

    string tempPath = Path.Combine(Server.MapPath("~/Temp/"), 
        $"{DateTime.Now:yyyyMMddHHmmssfff}{ext}");
    Directory.CreateDirectory(Path.GetDirectoryName(tempPath));
    FileUpload1.SaveAs(tempPath);

    try
    {
        // 2. 建立 OleDb 連接字串
        string connStr = GetExcelConnStr(tempPath, ext, hasHeader: true);
        
        using (var conn = new OleDbConnection(connStr))
        {
            conn.Open();
            
            // 3. 取得第一個工作表名稱
            DataTable schema = conn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, null);
            if (schema.Rows.Count == 0)
                throw new Exception("找不到工作表");
            string sheetName = schema.Rows[0]["TABLE_NAME"].ToString(); // 如 Sheet1$
            
            // 4. 查詢資料
            string sql = $"SELECT * FROM [{sheetName}]";
            using (var da = new OleDbDataAdapter(sql, conn))
            {
                var ds = new DataSet();
                da.Fill(ds);
                GridView1.DataSource = ds.Tables[0];
                GridView1.DataBind();
                lblMsg.Text = $"匯入成功,共 {ds.Tables[0].Rows.Count} 筆";
            }
        }
    }
    catch (Exception ex)
    {
        lblMsg.Text = $"錯誤: {ex.Message}";
    }
    finally
    {
        // 5. 清理暫存檔
        if (File.Exists(tempPath)) File.Delete(tempPath);
    }
}

private string GetExcelConnStr(string filePath, string ext, bool hasHeader)
{
    string hdr = hasHeader ? "YES" : "NO";
    if (ext == ".xls") // Excel 97-2003
        return $"Provider=Microsoft.Jet.OLEDB.4.0;Data Source={filePath};Extended Properties='Excel 8.0;HDR={hdr};IMEX=1;'";
    else // .xlsx Excel 2007+
        return $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filePath};Extended Properties='Excel 12.0 Xml;HDR={hdr};IMEX=1;'";
}

關鍵參數解析

參數說明
HDR=YES/NO第一行是否為標題(YES=標題,NO=資料)
IMEX=1混合類型欄位強制以文字讀取,避免數字/日期混雜導致前幾行為 null
Extended PropertiesExcel 8.0 (.xls) / Excel 12.0 Xml (.xlsx)

部署環境必要條件

  1. 安裝 Microsoft Access Database Engine(x64 版對應 64 位元 IIS 應用程式集區)。
    • .xls 需 AccessDatabaseEngine.exe (2010/2016/2019)
    • .xlsx 需 AccessDatabaseEngine_X64.exe (ACE 12.0/16.0)
  2. IIS 應用程式集區 啟用 32 位元應用程式 = False(若用 x64 Driver),或 True(若用 x86 Driver)。
  3. 暫存目錄 ~/Temp/ 需給 IIS_IUSRS 寫入權限。

常見錯誤與解決

錯誤原因解決
'Microsoft.Jet.OLEDB.4.0' 未註冊64 位元進程無法載入 32 位元 Jet 驅動改用 ACE 12.0+ x64、或啟用應用程式集區 32 位元
外部資料表不是預期的格式檔案損壞/非 Excel/副檔名與實際格式不符驗證檔案簽名、嘗試兩種連接字串
數字欄位讀成 null前幾行是數字,後面混入文字,驅動推斷為數字型別加 IMEX=1、或 TypeGuessRows=0(註冊表)
工作表名稱帶 $ 符號OleDb schema 回傳 'Sheet1$'SQL 中用 [Sheet1$] 包含括號

現代化替代:NPOI / EPPlus / ClosedXML(無驅動相依)

// NPOI 讀取 .xlsx 無需安裝任何驅動
using (var fs = new FileStream(tempPath, FileMode.Open))
{
    var wb = new XSSFWorkbook(fs);
    var sheet = wb.GetSheetAt(0);
    var dt = new DataTable();
    // 解析標題行...
    foreach (var row in sheet) { /* 建立 DataRow */ }
    GridView1.DataSource = dt; GridView1.DataBind();
}
  • 優點:純 managed code、跨平台、無驅動安裝與位元數困擾、支援 .xls/.xlsx 統一 API。
  • 建議:新專案直接用 NPOI/ClosedXML,舊專案維護才用 OleDb。

結語

OleDb 讀取 Excel 是經典方案,但環境相依性極高(驅動版本、位元數、註冊表)。掌握連接字串參數、暫存檔管理、工作表名稱動態取得、IMEX=1 混合類型處理,可解決 90% 匯入問題。長遠規劃請遷移至 NPOI/ClosedXML,徹底消除伺服器端 Office 元件相依。

copyright © 萬盛學電腦網 all rights reserved