在ASP.NET MVC中使用 IronXL和C#讀取Excel文件

Curtis Chau
Curtis Chau
已更新: 2026年8月2日

IronXL使得ASP.NET MVC開發者能在C#中直接讀取Excel文件,無需依賴Microsoft Office,只需幾行程式碼即可將Excel數據轉換為System.Data.DataTable,便於在網頁視圖中顯示。

快速入門:在 MVC 中加載和轉換 Excel 工作表為 DataTable

此範例展示了如何在幾秒內開始:載入一個Excel工作簿,選擇其第一個工作表,並使用IronXL將其轉換為System.Data.DataTable - 無需Interop,無麻煩。

  1. 1使用 IronXL 安裝 NuGet Package Manager

    PM > Install-Package IronXL.Excel

  2. 2複製並運行這段程式碼。

    var dataTable = IronXL.WorkBook.Load("CustomerData.xlsx").DefaultWorkSheet.ToDataTable(true);
  3. 3部署到您的生產環境進行測試

    立即在您的項目中開始使用 IronXL,並使用 免費試用
    arrow pointer

如何創建一個用於讀取Excel的ASP.NET專案?

為什麼Visual Studio 2022是最佳選擇?

使用 Visual Studio 2022 建立一個新的 ASP.NET 專案。 Visual Studio 2022為.NET 6+框架提供了出色的支援,改善了IronXL方法的IntelliSense,且在處理大型Excel文件時性能更佳。 IDE的NuGet整合使得安裝IronXL非常簡單明瞭。

我應該選擇哪個專案模板?

若要在 ASP.NET 中閱讀 Excel 檔案,請選擇「ASP.NET Core Web App (Model-View-Controller)」範本。 本範本提供簡潔的 MVC 架構,將資料處理 (Excel 讀取) 與簡報邏輯分離。 MVC 模式與 IronXL 的 DataTable 轉換完美協作,使您能在控制器中載入試算表並在視圖中顯示它們。

推薦使用哪個 .NET 版本?

IronXL支持.NET Framework 4.6.2+和.NET Core 3.1+。 對於新的 ASP.NET MVC 專案,請使用 .NET 6.0 或更高版本,以獲得最佳效能與安全性。 這些版本在處理大型 Excel 檔案時提供更好的記憶體管理,並在轉換試算表檔案類型時提供更好的 async/await 支援。

如何安裝IronXL程式庫?

安裝要求是什麼?


哪種安裝方法最快?

創建新專案後,安裝IronXL程式庫。 按照這些步驟安裝IronXL。 開啟 NuGet 套件管理器控制台並執行以下命令:

PM > Install-Package IronXL.Excel

如何驗證安裝?

若要驗證IronXL是否正確安裝,請檢查專案在Solution Explorer中的相依性。 您應該可以在「相依性 > 套件」中看到「IronXL」。 另外,嘗試在控制器文件頂部添加using IronXL; - IntelliSense應立即識別該命名空間。 若要排除安裝問題,請訪問授權指南。

如何在我的控制器中讀取Excel文件?

哪些代碼放在控制器操作中?

在您的 ASP.NET 專案中打開預設控制器(例如,HomeController.cs),並用以下代碼替換 Index 方法:

using IronXL;
using System.Data;

public ActionResult Index()
{
    // Load the Excel workbook from a specified path.
    WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");

    // Access the first worksheet from the workbook.
    WorkSheet workSheet = workBook.WorkSheets.First();

    // Convert the worksheet data to a DataTable object.
    // The 'true' parameter uses the first row as column headers
    var dataTable = workSheet.ToDataTable(true);

    // Send the DataTable to the view for rendering.
    return View(dataTable);
}

為什麼使用DataTable而不是其他格式?

在 Index 動作方法中,使用 IronXL 的 Load 方法載入 Excel 檔案。 Excel 檔案的路徑(包括檔案名稱)會作為參數傳遞給方法呼叫。 接著,選擇第一個Excel工作表作為工作表,並將其中包含的數據載入到DataTable對象中。 最後,將DataTable發送至前端。

DataTable非常適合ASP.NET MVC,因為它可以與Razor視圖整合,並提供內建支援以循環遍歷行和列。 與自定義對象不同,DataTable不需要模型映射,並且能自動處理混合數據類型。 您也可以在需要時將 DataSet 和 DataTable 匯出回 Excel。

丟失文件的錯誤處理如何處理?

可靠的錯誤處理可確保應用程式在Excel文件缺失或損壞時不會崩潰。 以下是適當異常處理的增強版:

public ActionResult Index()
{
    try
    {
        string filePath = @"C:\Files\Customer Data.xlsx";
        
        // Check if file exists before attempting to load
        if (!System.IO.File.Exists(filePath))
        {
            ViewBag.Error = "Excel file not found at specified location.";
            return View(new DataTable());
        }

        // Load workbook with error handling
        WorkBook workBook = WorkBook.Load(filePath);
        
        // Verify worksheet exists
        if (workBook.WorkSheets.Count == 0)
        {
            ViewBag.Error = "No worksheets found in the Excel file.";
            return View(new DataTable());
        }

        WorkSheet workSheet = workBook.WorkSheets.First();
        var dataTable = workSheet.ToDataTable(true);
        
        return View(dataTable);
    }
    catch (Exception ex)
    {
        // Log the exception (consider using a logging framework)
        ViewBag.Error = $"Error reading Excel file: {ex.Message}";
        return View(new DataTable());
    }
}

如何選擇不同的工作表?

IronXL提供多種方式選擇並處理特定工作表。 您可以依索引、名稱存取工作表,或遍歷所有可用的工作表:

// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");

// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];

// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string sheetName = sheet.Name;
    // Process each worksheet
}

如何在網頁上顯示Excel數據?

需要哪些視圖代碼?

下一個範例顯示如何在網頁瀏覽器中顯示前一個範例中返回的DataTable。

本範例中使用的 Excel 檔案如下所示:

含客戶姓名、運費與單價的 Excel 試算表 - 用於網頁顯示教學的範例資料

Excel 檔案

打開index.cshtml(index視圖)並將代碼替換為以下HTML代碼:

@{
    ViewData["Title"] = "Home Page";
}

@using System.Data
@model DataTable

<div class="text-center">
    <h1 class="display-4">Welcome to IronXL Read Excel MVC</h1>
</div>

@* Check for errors first *@
@if (ViewBag.Error != null)
{
    <div class="alert alert-danger">
        @ViewBag.Error
    </div>
}

@* Display table only if data exists *@
@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}
else
{
    <p>No data to display.</p>
}
Razor

為何使用Bootstrap進行表格樣式設計?

上述代碼使用從 Index 方法返回的 DataTable 作為模型。 每個表格中的行都使用@for循環在網頁上打印,包括Bootstrap格式進行修飾。

Bootstrap 提供可自動依據不同螢幕尺寸調整的回應式表格設計 - 這對於現代網路應用程式而言至關重要。 table-dark類別創建了一個美觀的深色主題表格,易於閱讀。 對於更高級的Excel格式,如單元格邊框和對齊或背景圖案和顏色,IronXL提供額外的方法來直接存取結構化數據。

最終輸出的樣子是怎樣的?

執行專案的結果如下所示:

ASP.NET MVC 應用程式中的 Bootstrap 表格,顯示含姓名、運費與單價的 Excel 客戶資料

Bootstrap 表格

如何為表格添加表頭?

若要顯示 Excel 檔案中的列頭,請修改檢視程式碼,以包含表頭部分。 調用 ToDataTable(true) 時,IronXL 自動使用第一行作為列名:

@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <thead>
            <tr>
                @foreach (DataColumn column in Model.Columns)
                {
                    <th>@column.ColumnName</th>
                }
            </tr>
        </thead>
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}

此增強功能從您的Excel文件中顯示合適的列標題,如「客戶姓名」、「運輸成本」和「單位價格」。對於涉及命名範圍或命名表格的更複雜場景,IronXL提供額外的方法來直接存取結構化數據。

常見問題

什麼是IronXL?

IronXL 是一個 C# 程式庫,允許 ASP.NET MVC 開發者讀取、編輯和操作 Excel 文件,無需依賴 Microsoft Office。它提供將 Excel 工作表轉換為 System.Data.DataTable 的功能,便於輕鬆整合到網頁應用程式中。

IronXL 如何在 ASP.NET MVC 中實現讀取 Excel 文件的功能?

IronXL 允許開發者載入 Excel 工作簿,並輕鬆地將工作表轉換為 System.Data.DataTable 物件,只需幾行代碼,即可在 ASP.NET MVC 應用程式中顯示 Excel 數據。

使用 IronXL 與 ASP.NET MVC 的好處有哪些?

IronXL 通過消除對 Microsoft Office Interop 的依賴來簡化 Excel 文件操作,提供了一種直接的方式來將試算表數據整合到網頁視圖中,並通過先進的記憶體管理來提高應用程式性能。

哪些.NET版本與IronXL兼容?

IronXL 與 .NET Framework 4.6.2 及更高版本,以及 .NET Core 3.1 和更新版本包括 .NET 6.0 兼容。這些版本確保了在處理 Excel 文件時的最佳性能和現代功能。

如何在網頁上使用 IronXL 顯示 Excel 數據?

將轉換為 DataTable 格式的 Excel 數據傳遞給 ASP.NET MVC 的 Razor 視圖即可在網頁上顯示。這是通過使用 Razor 語法和 HTML 來遍歷表格列和欄,並將它們以 Bootstrap 風格的表格呈現出來。

為什麼選擇使用 IronXL 的 DataTable 格式?

DataTable 格式對於 ASP.NET MVC 應用程式來說是理想的,因為它可以與 Razor 視圖整合,允許對數據列和欄進行直觀的迭代,無需進行模型映射,並且可以有效地處理混合數據類型。

在 ASP.NET MVC 專案中安裝 IronXL 需要哪些步驟?

安裝過程包括通過 Visual Studio 中的 NuGet 套件管理器添加 IronXL。這需要打開 NuGet 套件管理器控制台並執行特定指令來將 IronXL 添加到專案的依賴項中。

使用 IronXL 讀取 Excel 文件時如何處理錯誤?

IronXL 支援可靠的錯誤處理,例如在檔案載入前檢查文件是否存在,捕捉工作簿載入過程中的例外情況,以及管理缺失工作表的情形。這確保了即使 Excel 文件損壞或丟失,應用程式也能穩定運行。

IronXL 可以選擇 Excel 文件中的特定工作表嗎?

可以,IronXL 允許開發者根據名稱、索引或預設設定選擇工作表,還提供遍歷工作簿中所有可用工作表的功能。

在網頁應用中使用 IronXL 顯示 Excel 數據的樣式選擇有哪些?

將 IronXL 與 ASP.NET MVC 結合使用時,提供如 Bootstrap 這樣的樣式選擇來打造響應式表格佈局,還有額外的 IronXL 方法可以設定單元格邊框、對齊、圖案和顏色。

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 2,393,101版本:2026.11剛剛發布