如何在ASP.NET C#中將Excel匯入GridView

如何安裝IronXL以進行Excel GridView整合？

在編寫任何代碼之前，您需要將IronXL添加到您的ASP.NET專案中。 最快的方法是通過NuGet，可以從Visual Studio包管理器控制台或.NET CLI使用。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

安裝後，NuGet會將所有必需的引用添加到您的專案中。 不需要安裝外部驅動程式，不需要註冊OLEDB提供者，並且在伺服器上沒有Microsoft Office的依賴性。 該程式庫作為單個受管理的組件提供，可在Windows、Linux、macOS以及包括Azure App Service的雲託管環境中使用。

安裝後，將以下命名空間添加到任何讀取或寫入Excel數據的程式碼後文件中：

using IronXL;
using System.Data;
using System.IO;

using IronXL;
using System.Data;
using System.IO;

IronXL同時支持.xls（Excel 97-2003）和.xlsx（Excel 2007+）格式，因此您不需要對每種文件類型進行單獨處理。 同樣的WorkBook.Load調用會自動通過檢查文件簽名來處理任何格式。

將Excel數據載入GridView的最快方法是什麼？

最快的方法是將GridView.DataBind結合到大約四行有效代碼中。 在基本情況下，無需手動創建列和迭代行。

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

DataTable中提升工作表的第一行到列名。 當您使用GridView時，ASP.NET會自動為每個Excel標題創建一列。

如何創建一個ASP.NET Web Forms頁面來導入Excel？

一個最小的導入頁面需要三個控件：一個文件上傳輸入、一個提交按鈕和GridView。 在<form runat="server">元素中加入如下的ASPX標記：

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

如果您正在使用Bootstrap樣式表，CssClass屬性將網格接入到您的Bootstrap樣式表中，無需額外配置即可獲得樣式行和邊框。

在後端程式碼中，處理按鈕點擊事件。 下面的模式保存上傳的文件到臨時伺服器路徑，使用IronXL載入並將結果DataTable綁定到網格：

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

此實施在遵循頂級語句風格的事件處理器中保留了必要的Web Forms事件簽名。 請注意，Uploads文件夾已經存在，則調用為空操作。

用戶選擇一個.xlsx文件並點擊上傳按鈕後，網格將填充電子表格內容。 列名來自Excel文件的第一行，所有後續行成為網格中的數據行。

string ext = Path.GetExtension(FileUpload1.FileName).To低erInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

string ext = Path.GetExtension(FileUpload1.FileName).To低erInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

如何訪問特定的工作表和單元格範圍？

當一個Excel工作簿包含多個工作表時，您需要按名稱而不是依賴於DefaultWorkSheet來定位特定的工作表。 IronXL提供一個GetWorkSheet方法，接受工作表標籤名稱作為字串。

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

您的應用需要顯示多個工作表上的數據或讓用戶選擇查看哪一個工作表時，ToDataSet方法便很有用。 返回的DataTable對應於一個Excel工作表，表名與標籤名相匹配。

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

如何比較Excel GridView綁定的匯入方法？

不同的Excel到GridView綁定方法有不同的權衡。 下表總結了最常見的方法，以便您為您的情境選擇合適的方法。

IronXL涵蓋了遺留的XLS和現代的XLSX格式，不需要伺服器端驅動程式安裝，並提供了列出的選項中最低的程式碼複雑性。 對於已經使用其他Iron Software產品如IronPDF或IronOCR的團隊，一個Iron Software授權覆蓋整個套件。

如何將GridView數據導出回Excel？

使用IronXL 從Excel進入到網格，並返回到Excel的完整過程同樣簡明。 這個模式對於"下載為Excel"按鈕很有用，允許使用者匯出當前在網格中顯示的內容。

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

Response.TransmitFile調用將保存的文件流傳輸到瀏覽器，觸發下載對話框。 Content-Disposition: attachment標頭確保瀏覽器下載文件而不是嘗試內聯顯示。

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXl.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXl.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

您接下來的步驟是什麼？

您現在擁有一個完整的，無需驅動程式的管道，可將Excel文件導入到ASP.NET GridView，並使用IronXL將GridView數據導出回Excel。 接下來您可以探索以下內容以在此基礎上進行構建：

• 閱讀IronXL文檔以獲得完整的API參考，包括公式計算、單元格範圍操作和圖表創建。
• 探索IronXL代碼示例庫，其中包含可立即執行的代碼段，涵蓋CSV匯入、密碼保護工作簿、條件格式等。
• 如果想更深入了解類型化列映射和空值處理，請嘗試Excel to DataTable教程。
• 查看IronXL授權頁面以檢查從開發授權到OEM再分發的選項。
• 查看Iron Software 的.NET Excel 閱讀指南以詳細了解工作簿和工作表的導航。
• 使用C# Excel程式庫比較將IronXL與替代方案進行比較，以功能為基礎的方式對比OLEDB、EPPlus和Open XML SDK。

對於.NET Core和ASP.NET Core應用程式，相同的IronXL API將在Razor Pages和MVC控制器中工作。 IronXL ASP.NET Core指南對文件上傳處理和依賴注入模式的差異進行了說明。

如果您在文檔生成的同時整合IronXL，IronPDF整合指南展示了如何除了Excel之外，將GridView數據導出到PDF報告——這對同時需要這兩種格式的應用程式非常有用。

從IronXL免費試用版開始，您可以在購買前測試所有功能。 試用授權無需信用卡。