透過 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 Properties | Excel 8.0 (.xls) / Excel 12.0 Xml (.xlsx) |
AccessDatabaseEngine.exe (2010/2016/2019)AccessDatabaseEngine_X64.exe (ACE 12.0/16.0)~/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 讀取 .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();
}
OleDb 讀取 Excel 是經典方案,但環境相依性極高(驅動版本、位元數、註冊表)。掌握連接字串參數、暫存檔管理、工作表名稱動態取得、IMEX=1 混合類型處理,可解決 90% 匯入問題。長遠規劃請遷移至 NPOI/ClosedXML,徹底消除伺服器端 Office 元件相依。