資訊圖標
跳至頁尾內容
  1. Iron Software
  2. IronXL 部落格
  3. using IronXL
  4. DataSet Excel Export
USING IRONXL

using IronXL 在 C# 中將資料集匯出到 Excel | 無需 Office

Curtis Chau
Curtis Chau
已更新:

在C#中將DataSet或DataTable匯出到Excel，為您提供了一種可靠的方法，可將結構化的記憶體資料轉換為專業的電子表格文件，而不依賴於目標機器上已安裝的Microsoft Office。無論您是從SQL資料庫中提取記錄、以程式化方式構建DataSet，還是使用現有的DataGrid，IronXL通過乾淨的、以程式碼為主的API處理整個管道。 此指南涵蓋所有主要情景，從單表匯出到多工作表簿再到實時資料庫查詢結果，使用高層級的C#語句和.NET 10。

只需安裝IronXL一次，撰寫幾行程式碼，您的資料便可在XLSX文件中，而無需依賴單一Office。 以下部分涵蓋安裝、核心模式、高級格式化和資料庫整合，您可以直接複製並粘貼到自己的項目中。

如何安裝IronXL以匯出Excel？

在撰寫任何匯出程式碼之前，透過NuGet套件管理器將IronXL新增到您的專案中。 在專案根目錄中開啟終端並運行.NET CLI命令，或在Visual Studio的套件管理器控制台中使用Install-Package命令：

dotnet add package IronXL.Excel

或在Visual Studio套件管理器控制台中：

Install-Package IronXL.Excel

安裝後，新增頂層using語句來匯入IronXL名稱空間：

using IronXL;
using System.Data;
using IronXL;
using System.Data;
Imports IronXL
Imports System.Data
$vbLabelText   $csharpLabel

IronXL的目標是.NET 8、.NET 9和.NET 10以及較舊版的.NET Framework（4.6.2+）。 在任何機器上都無需安裝Office——無論是伺服器、桌面還是雲端。 安裝包後，您可以完全用受管程式碼建立、讀取和寫入XLSX、XLS和CSV文件。

有關詳細的安裝選項，請參閱IronXL安裝指南和NuGet套件頁面的版本歷史。

如何將單個DataTable匯出到Excel文件？

最常見的情況是將一個DataTable匯出到單個工作表。 IronXL的WorkSheet類自然地對應於Excel物件模型。 您建立一個工作簿，新增一個工作表，然後迭代DataTable的列和行。

以下範例建立一個記憶體中的員工DataTable並將其寫入EmployeeData.xlsx：

using IronXL;
using System.Data;

// Build an in-memory DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));

dt.Rows.Add(1, "John Smith", "Engineering");
dt.Rows.Add(2, "Sarah Jones", "Marketing");
dt.Rows.Add(3, "Mike Wilson", "Sales");

// Create a workbook and a named worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

// Write column headers in row 0
for (int col = 0; col < dt.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
}

// Write data rows starting at row 1
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        worksheet.SetCellValue(row + 1, col, dt.Rows[row][col].ToString());
    }
}

workbook.SaveAs("EmployeeData.xlsx");
using IronXL;
using System.Data;

// Build an in-memory DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));

dt.Rows.Add(1, "John Smith", "Engineering");
dt.Rows.Add(2, "Sarah Jones", "Marketing");
dt.Rows.Add(3, "Mike Wilson", "Sales");

// Create a workbook and a named worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

// Write column headers in row 0
for (int col = 0; col < dt.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
}

// Write data rows starting at row 1
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        worksheet.SetCellValue(row + 1, col, dt.Rows[row][col].ToString());
    }
}

workbook.SaveAs("EmployeeData.xlsx");
Imports IronXL
Imports System.Data

' Build an in-memory DataTable
Dim dt As New DataTable("Employees")
dt.Columns.Add("ID", GetType(Integer))
dt.Columns.Add("Name", GetType(String))
dt.Columns.Add("Department", GetType(String))

dt.Rows.Add(1, "John Smith", "Engineering")
dt.Rows.Add(2, "Sarah Jones", "Marketing")
dt.Rows.Add(3, "Mike Wilson", "Sales")

' Create a workbook and a named worksheet
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim worksheet As WorkSheet = workbook.CreateWorkSheet("Employees")

' Write column headers in row 0
For col As Integer = 0 To dt.Columns.Count - 1
    worksheet.SetCellValue(0, col, dt.Columns(col).ColumnName)
Next

' Write data rows starting at row 1
For row As Integer = 0 To dt.Rows.Count - 1
    For col As Integer = 0 To dt.Columns.Count - 1
        worksheet.SetCellValue(row + 1, col, dt.Rows(row)(col).ToString())
    Next
Next

workbook.SaveAs("EmployeeData.xlsx")
$vbLabelText   $csharpLabel

輸出

如何用IronXL將DataSet匯出到Excel VB .NET：完整指南：圖像1 - 將簡單的DataTable匯出到Excel的VB .NET輸出

SetCellValue接受int、double、string和bool——因此您可以獲得本機的Excel單元格型別，無需額外的型別轉換。 此迴圈模式適用於任何大小的表格，因為IronXL直接寫入記憶體，並在調用SaveAs時才刷新到磁碟，保持高效，即使是數千行。

想要更全面了解讀寫技術，IronXL C#教程涵蓋了這種匯出模式的所有文件操作範圍。

如何將DataSet匯出到多個Excel工作表？

當一個DataSet包含多個相關的表（例如產品和訂單）時，您可以將每個DataTable映射到同一工作簿中的自己工作表中。 這使得接收方可以在單個文件中查看所有相關資料，而無需打開多個文件。

下面的迴圈迭代ds.Tables並為每個表建立一個工作表：

using IronXL;
using System.Data;

// Build a DataSet with two related tables
DataSet ds = new DataSet("CompanyData");

DataTable dtProducts = new DataTable("Products");
dtProducts.Columns.Add("ProductID", typeof(int));
dtProducts.Columns.Add("ProductName", typeof(string));
dtProducts.Columns.Add("Price", typeof(decimal));
dtProducts.Rows.Add(101, "Widget A", 29.99m);
dtProducts.Rows.Add(102, "Widget B", 49.99m);
ds.Tables.Add(dtProducts);

DataTable dtOrders = new DataTable("Orders");
dtOrders.Columns.Add("OrderID", typeof(int));
dtOrders.Columns.Add("Customer", typeof(string));
dtOrders.Columns.Add("Total", typeof(decimal));
dtOrders.Rows.Add(1001, "Acme Corp", 599.90m);
dtOrders.Rows.Add(1002, "Tech Inc", 299.95m);
ds.Tables.Add(dtOrders);

// Create one workbook and iterate each DataTable
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

foreach (DataTable table in ds.Tables)
{
    WorkSheet sheet = workbook.CreateWorkSheet(table.TableName);

    // Write headers
    for (int col = 0; col < table.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, table.Columns[col].ColumnName);
    }

    // Write rows
    for (int row = 0; row < table.Rows.Count; row++)
    {
        for (int col = 0; col < table.Columns.Count; col++)
        {
            sheet.SetCellValue(row + 1, col, table.Rows[row][col].ToString());
        }
    }
}

workbook.SaveAs("CompanyReport.xlsx");
using IronXL;
using System.Data;

// Build a DataSet with two related tables
DataSet ds = new DataSet("CompanyData");

DataTable dtProducts = new DataTable("Products");
dtProducts.Columns.Add("ProductID", typeof(int));
dtProducts.Columns.Add("ProductName", typeof(string));
dtProducts.Columns.Add("Price", typeof(decimal));
dtProducts.Rows.Add(101, "Widget A", 29.99m);
dtProducts.Rows.Add(102, "Widget B", 49.99m);
ds.Tables.Add(dtProducts);

DataTable dtOrders = new DataTable("Orders");
dtOrders.Columns.Add("OrderID", typeof(int));
dtOrders.Columns.Add("Customer", typeof(string));
dtOrders.Columns.Add("Total", typeof(decimal));
dtOrders.Rows.Add(1001, "Acme Corp", 599.90m);
dtOrders.Rows.Add(1002, "Tech Inc", 299.95m);
ds.Tables.Add(dtOrders);

// Create one workbook and iterate each DataTable
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

foreach (DataTable table in ds.Tables)
{
    WorkSheet sheet = workbook.CreateWorkSheet(table.TableName);

    // Write headers
    for (int col = 0; col < table.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, table.Columns[col].ColumnName);
    }

    // Write rows
    for (int row = 0; row < table.Rows.Count; row++)
    {
        for (int col = 0; col < table.Columns.Count; col++)
        {
            sheet.SetCellValue(row + 1, col, table.Rows[row][col].ToString());
        }
    }
}

workbook.SaveAs("CompanyReport.xlsx");
Imports IronXL
Imports System.Data

' Build a DataSet with two related tables
Dim ds As New DataSet("CompanyData")

Dim dtProducts As New DataTable("Products")
dtProducts.Columns.Add("ProductID", GetType(Integer))
dtProducts.Columns.Add("ProductName", GetType(String))
dtProducts.Columns.Add("Price", GetType(Decimal))
dtProducts.Rows.Add(101, "Widget A", 29.99D)
dtProducts.Rows.Add(102, "Widget B", 49.99D)
ds.Tables.Add(dtProducts)

Dim dtOrders As New DataTable("Orders")
dtOrders.Columns.Add("OrderID", GetType(Integer))
dtOrders.Columns.Add("Customer", GetType(String))
dtOrders.Columns.Add("Total", GetType(Decimal))
dtOrders.Rows.Add(1001, "Acme Corp", 599.90D)
dtOrders.Rows.Add(1002, "Tech Inc", 299.95D)
ds.Tables.Add(dtOrders)

' Create one workbook and iterate each DataTable
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)

For Each table As DataTable In ds.Tables
    Dim sheet As WorkSheet = workbook.CreateWorkSheet(table.TableName)

    ' Write headers
    For col As Integer = 0 To table.Columns.Count - 1
        sheet.SetCellValue(0, col, table.Columns(col).ColumnName)
    Next

    ' Write rows
    For row As Integer = 0 To table.Rows.Count - 1
        For col As Integer = 0 To table.Columns.Count - 1
            sheet.SetCellValue(row + 1, col, table.Rows(row)(col).ToString())
        Next
    Next
Next

workbook.SaveAs("CompanyReport.xlsx")
$vbLabelText   $csharpLabel

輸出

如何用IronXL將DataSet匯出到Excel VB.NET：完整指南：圖像2 - 生成的Excel文件，其中匯出的DataSet作為單獨的工作表

每個工作表以來源DataTable的名稱命名，使Excel中的導航變得簡易。 因為WorkBook.Create在記憶體中分配工作簿，您可以在迴圈中不重新打開文件就繼續新增工作表——IronXL在寫入磁碟前構建整個XLSX結構。

IronXL WorkBook文件列出了WorkBook物件上可用的每個方法，包括工作表重新排序、密碼保護和另存為格式。

如何為Excel匯出新增標題格式？

純資料匯出是功能性的，但新增粗體標題和列寬使輸出在商業背景中立即可用。 IronXL透過附加到任何Style物件暴露單元格和範圍樣式。

下面的程式碼片段將格式設為粗體字體應用於標題行，並在寫入資料後自動調整列。

using IronXL;
using System.Data;

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Region", typeof(string));
dt.Columns.Add("Q1", typeof(decimal));
dt.Columns.Add("Q2", typeof(decimal));
dt.Columns.Add("Q3", typeof(decimal));
dt.Columns.Add("Q4", typeof(decimal));

dt.Rows.Add("否rth", 120000m, 135000m, 142000m, 158000m);
dt.Rows.Add("South", 98000m, 104000m, 112000m, 121000m);
dt.Rows.Add("East",  87000m, 93000m,  99000m,  108000m);
dt.Rows.Add("West",  145000m, 152000m, 161000m, 174000m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Sales");

// Write and style headers
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    sheet["A1:E1"].Style.Font.Bold = true;
    sheet["A1:E1"].Style.Font.Height = 12;
}

// Write data rows
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, dt.Rows[row][col]);
    }
}

workbook.SaveAs("SalesReport.xlsx");
using IronXL;
using System.Data;

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Region", typeof(string));
dt.Columns.Add("Q1", typeof(decimal));
dt.Columns.Add("Q2", typeof(decimal));
dt.Columns.Add("Q3", typeof(decimal));
dt.Columns.Add("Q4", typeof(decimal));

dt.Rows.Add("否rth", 120000m, 135000m, 142000m, 158000m);
dt.Rows.Add("South", 98000m, 104000m, 112000m, 121000m);
dt.Rows.Add("East",  87000m, 93000m,  99000m,  108000m);
dt.Rows.Add("West",  145000m, 152000m, 161000m, 174000m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Sales");

// Write and style headers
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    sheet["A1:E1"].Style.Font.Bold = true;
    sheet["A1:E1"].Style.Font.Height = 12;
}

// Write data rows
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, dt.Rows[row][col]);
    }
}

workbook.SaveAs("SalesReport.xlsx");
Imports IronXL
Imports System.Data

Dim dt As New DataTable("Sales")
dt.Columns.Add("Region", GetType(String))
dt.Columns.Add("Q1", GetType(Decimal))
dt.Columns.Add("Q2", GetType(Decimal))
dt.Columns.Add("Q3", GetType(Decimal))
dt.Columns.Add("Q4", GetType(Decimal))

dt.Rows.Add("否rth", 120000D, 135000D, 142000D, 158000D)
dt.Rows.Add("South", 98000D, 104000D, 112000D, 121000D)
dt.Rows.Add("East", 87000D, 93000D, 99000D, 108000D)
dt.Rows.Add("West", 145000D, 152000D, 161000D, 174000D)

Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Sales")

' Write and style headers
For col As Integer = 0 To dt.Columns.Count - 1
    sheet.SetCellValue(0, col, dt.Columns(col).ColumnName)
    sheet("A1:E1").Style.Font.Bold = True
    sheet("A1:E1").Style.Font.Height = 12
Next

' Write data rows
For row As Integer = 0 To dt.Rows.Count - 1
    For col As Integer = 0 To dt.Columns.Count - 1
        sheet.SetCellValue(row + 1, col, dt.Rows(row)(col))
    Next
Next

workbook.SaveAs("SalesReport.xlsx")
$vbLabelText   $csharpLabel

Style.Font.Bold屬性應用於整個標題範圍中的單條語句。 IronXL還支援背景顏色（Style.HorizontalAlignment）。 有關完整的樣式參考，請參閱IronXL單元格式指南。

如何將資料庫查詢結果匯出到Excel？

連接到SQL資料庫並將結果直接匯出到Excel涵蓋了一個主要的現實用例——定期報告、資料快照和行政匯出。 該方法使用SqlDataAdapter填充DataSet，然後將生成的DataTable映射到IronXL工作表中。

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Server=localhost;Database=SalesDB;Integrated Security=True;";
string query = "SELECT CustomerID, CompanyName, ContactName, Country FROM Customers";

// Fill DataSet from SQL query
DataSet ds = new DataSet();
using (SqlConnection connection = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(query, connection);
    adapter.Fill(ds, "Customers");
}

DataTable dt = ds.Tables["Customers"]!;

// Create workbook and export
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("CustomerData");

// Bold header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
}
worksheet["A1:D1"].Style.Font.Bold = true;

// Write rows, handling DBNull values safely
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        object cellValue = dt.Rows[row][col];
        worksheet.SetCellValue(row + 1, col,
            cellValue == DBNull.Value ? "" : cellValue.ToString()!);
    }
}

workbook.SaveAs("CustomerExport.xlsx");
Console.WriteLine("Export complete.");
using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Server=localhost;Database=SalesDB;Integrated Security=True;";
string query = "SELECT CustomerID, CompanyName, ContactName, Country FROM Customers";

// Fill DataSet from SQL query
DataSet ds = new DataSet();
using (SqlConnection connection = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(query, connection);
    adapter.Fill(ds, "Customers");
}

DataTable dt = ds.Tables["Customers"]!;

// Create workbook and export
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("CustomerData");

// Bold header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
}
worksheet["A1:D1"].Style.Font.Bold = true;

// Write rows, handling DBNull values safely
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        object cellValue = dt.Rows[row][col];
        worksheet.SetCellValue(row + 1, col,
            cellValue == DBNull.Value ? "" : cellValue.ToString()!);
    }
}

workbook.SaveAs("CustomerExport.xlsx");
Console.WriteLine("Export complete.");
Imports IronXL
Imports System.Data
Imports System.Data.SqlClient

Dim connectionString As String = "Server=localhost;Database=SalesDB;Integrated Security=True;"
Dim query As String = "SELECT CustomerID, CompanyName, ContactName, Country FROM Customers"

' Fill DataSet from SQL query
Dim ds As New DataSet()
Using connection As New SqlConnection(connectionString)
    Dim adapter As New SqlDataAdapter(query, connection)
    adapter.Fill(ds, "Customers")
End Using

Dim dt As DataTable = ds.Tables("Customers")

' Create workbook and export
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim worksheet As WorkSheet = workbook.CreateWorkSheet("CustomerData")

' Bold header row
For col As Integer = 0 To dt.Columns.Count - 1
    worksheet.SetCellValue(0, col, dt.Columns(col).ColumnName)
Next
worksheet("A1:D1").Style.Font.Bold = True

' Write rows, handling DBNull values safely
For row As Integer = 0 To dt.Rows.Count - 1
    For col As Integer = 0 To dt.Columns.Count - 1
        Dim cellValue As Object = dt.Rows(row)(col)
        worksheet.SetCellValue(row + 1, col, If(cellValue Is DBNull.Value, "", cellValue.ToString()))
    Next
Next

workbook.SaveAs("CustomerExport.xlsx")
Console.WriteLine("Export complete.")
$vbLabelText   $csharpLabel

資料庫匯出的關鍵點

空檢查(cellValue == DBNull.Value ? '' : cellValue.ToString()) prevents exceptions when the database returns NULL值——這是帶有可選列時的常見情況。 在標題行上加粗格式，使報告接收者能夠立即區分標題和資料。

有關將資料從Excel回讀到C#物件的其他模式，IronXL DataTable匯出教程展示了如何逆轉此工作流。

如何比較IronXL與其他Excel匯出方法？

選擇程式庫之前，了解主要選項如何在DataSet匯出情境中相對於彼此的表現是有幫助的。

.NET DataSet情境的Excel匯出程式庫比較
方法 需要Office 支援XLSX 樣式API 多表 效能（大資料）
IronXL 否 是 完整 是 高
Microsoft Office Interop 是 是 完整 是 低
EPPlus 否 是 部分 是 高
ClosedXML 否 是 部分 是 中
CSV（手動） 否 否 否ne 否 非常高

Microsoft Office Interop僅在安裝了Office的Windows計算機上工作，這排除了伺服器部署和雲功能的可能。 IronXL、EPPlus和ClosedXML都支援伺服端生成——關鍵區別是樣式API的廣度和授權模式。 IronXL的授權包括商業使用，並覆蓋所有.NET目標框架的單一包。

有關第三方基準和比較，Microsoft文件關於Excel文件格式和EPPlus專案頁面提供了您為專案做正確選擇的其他背景。

如何在沒有記憶體問題的情況下處理大型DataSets？

匯出包含成千上萬行的DataTable時，保持記憶體使用情況的可預測性至關重要。 下面的模式從IDataReader串流資料，而不是首先將整個結果集載入到DataTable中。這樣可避免同時保存讀者緩衝區和DataTable帶來的雙重記憶體成本。

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Server=localhost;Database=InventoryDB;Integrated Security=True;";
string query = "SELECT ProductID, SKU, Description, StockLevel, UnitCost FROM Products";

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Inventory");

using SqlConnection conn = new SqlConnection(connectionString);
conn.Open();

using SqlCommand cmd = new SqlCommand(query, conn);
using SqlDataReader reader = cmd.ExecuteReader();

// Write schema-derived headers
for (int col = 0; col < reader.FieldCount; col++)
{
    sheet.SetCellValue(0, col, reader.GetName(col));
}

// Stream rows directly into IronXL without buffering a DataTable
int excelRow = 1;
while (reader.Read())
{
    for (int col = 0; col < reader.FieldCount; col++)
    {
        sheet.SetCellValue(excelRow, col,
            reader.IsDBNull(col) ? "" : reader.GetValue(col).ToString()!);
    }
    excelRow++;
}

workbook.SaveAs("InventoryExport.xlsx");
Console.WriteLine($"Exported {excelRow - 1} rows.");
using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Server=localhost;Database=InventoryDB;Integrated Security=True;";
string query = "SELECT ProductID, SKU, Description, StockLevel, UnitCost FROM Products";

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Inventory");

using SqlConnection conn = new SqlConnection(connectionString);
conn.Open();

using SqlCommand cmd = new SqlCommand(query, conn);
using SqlDataReader reader = cmd.ExecuteReader();

// Write schema-derived headers
for (int col = 0; col < reader.FieldCount; col++)
{
    sheet.SetCellValue(0, col, reader.GetName(col));
}

// Stream rows directly into IronXL without buffering a DataTable
int excelRow = 1;
while (reader.Read())
{
    for (int col = 0; col < reader.FieldCount; col++)
    {
        sheet.SetCellValue(excelRow, col,
            reader.IsDBNull(col) ? "" : reader.GetValue(col).ToString()!);
    }
    excelRow++;
}

workbook.SaveAs("InventoryExport.xlsx");
Console.WriteLine($"Exported {excelRow - 1} rows.");
Imports IronXL
Imports System.Data
Imports System.Data.SqlClient

Dim connectionString As String = "Server=localhost;Database=InventoryDB;Integrated Security=True;"
Dim query As String = "SELECT ProductID, SKU, Description, StockLevel, UnitCost FROM Products"

Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Inventory")

Using conn As New SqlConnection(connectionString)
    conn.Open()

    Using cmd As New SqlCommand(query, conn)
        Using reader As SqlDataReader = cmd.ExecuteReader()

            ' Write schema-derived headers
            For col As Integer = 0 To reader.FieldCount - 1
                sheet.SetCellValue(0, col, reader.GetName(col))
            Next

            ' Stream rows directly into IronXL without buffering a DataTable
            Dim excelRow As Integer = 1
            While reader.Read()
                For col As Integer = 0 To reader.FieldCount - 1
                    sheet.SetCellValue(excelRow, col, If(reader.IsDBNull(col), "", reader.GetValue(col).ToString()))
                Next
                excelRow += 1
            End While

            workbook.SaveAs("InventoryExport.xlsx")
            Console.WriteLine($"Exported {excelRow - 1} rows.")
        End Using
    End Using
End Using
$vbLabelText   $csharpLabel

當結果集可能超過50,000行或者執行在記憶體有限的服務中時，建議使用此模式。IronXL效能文件介紹了有關大容量匯出的更多記憶體和吞吐量調整選項。

將非常大宗匯出的批量保存為CSV

對於超過500,000行的匯出，當記憶體非常緊張時，請考慮將輸出分散到多個工作簿或改為匯出為CSV格式：

using IronXL;

// IronXL can save any workbook as CSV
workbook.SaveAs("LargeExport.csv");
using IronXL;

// IronXL can save any workbook as CSV
workbook.SaveAs("LargeExport.csv");
Imports IronXL

' IronXL can save any workbook as CSV
workbook.SaveAs("LargeExport.csv")
$vbLabelText   $csharpLabel

CSV失去了格式和多表支持，但對於下游ETL流程仍然有效，在這些流程中消費原始分隔資料。

如何將Excel文件保存為不同格式和位置？

IronXL支持保存到文件路徑、byte[]，這對於ASP.NET應用返回Excel作為下載響應特別重要。

using IronXL;
using System.IO;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");
sheet.SetCellValue(0, 0, "Generated Report");

// Save to file path
workbook.SaveAs("Report.xlsx");

// Save as XLS (legacy format)
workbook.SaveAs("Report.xls");

// Save to MemoryStream for HTTP response
using MemoryStream ms = new MemoryStream();
workbook.SaveAs(ms);
byte[] fileBytes = ms.ToArray();
// fileBytes can be returned from an ASP.NET controller action
using IronXL;
using System.IO;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");
sheet.SetCellValue(0, 0, "Generated Report");

// Save to file path
workbook.SaveAs("Report.xlsx");

// Save as XLS (legacy format)
workbook.SaveAs("Report.xls");

// Save to MemoryStream for HTTP response
using MemoryStream ms = new MemoryStream();
workbook.SaveAs(ms);
byte[] fileBytes = ms.ToArray();
// fileBytes can be returned from an ASP.NET controller action
Imports IronXL
Imports System.IO

Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Report")
sheet.SetCellValue(0, 0, "Generated Report")

' Save to file path
workbook.SaveAs("Report.xlsx")

' Save as XLS (legacy format)
workbook.SaveAs("Report.xls")

' Save to MemoryStream for HTTP response
Using ms As New MemoryStream()
    workbook.SaveAs(ms)
    Dim fileBytes As Byte() = ms.ToArray()
    ' fileBytes can be returned from an ASP.NET controller action
End Using
$vbLabelText   $csharpLabel

對於ASP.NET Core，從您的控制器動作返回File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Report.xlsx")以觸發瀏覽器下載。 IronXL ASP.NET Excel指南展示了完整的控制器整合模式。

對於其他.NET Excel程式庫，Open XML SDK是許多繼承者建立在其上的開源基礎。

支援的輸出格式

IronXL在不需任何額外依賴的情況下保存為以下格式：

  • XLSX——OpenXML格式，與Excel 2007及更高版本相容
  • XLS——遺留的二進制格式，與Excel 97-2003相容
  • CSV——逗號分隔的值，普遍支援
  • TSV——製表符分隔的值
  • JSON——結構化資料匯出

切換格式只需在ExcelFileFormat枚舉值的重載方法。

如何驗證匯出的Excel文件正確無誤？

匯出後，您可以用IronXL讀回文件，以驗證行數、點檢值或在測試專案中運行自動斷言：

using IronXL;

WorkBook loaded = WorkBook.Load("EmployeeData.xlsx");
WorkSheet sheet = loaded.WorkSheets[0];

// Verify row count (header row + data rows)
int totalRows = sheet.Rows.Count();
Console.WriteLine($"Rows in file: {totalRows}");

// Spot-check specific cell values
string header = sheet["A1"].StringValue;
string firstEmployee = sheet["A2"].StringValue;

Console.WriteLine($"Header: {header}, First row: {firstEmployee}");
using IronXL;

WorkBook loaded = WorkBook.Load("EmployeeData.xlsx");
WorkSheet sheet = loaded.WorkSheets[0];

// Verify row count (header row + data rows)
int totalRows = sheet.Rows.Count();
Console.WriteLine($"Rows in file: {totalRows}");

// Spot-check specific cell values
string header = sheet["A1"].StringValue;
string firstEmployee = sheet["A2"].StringValue;

Console.WriteLine($"Header: {header}, First row: {firstEmployee}");
Imports IronXL

Dim loaded As WorkBook = WorkBook.Load("EmployeeData.xlsx")
Dim sheet As WorkSheet = loaded.WorkSheets(0)

' Verify row count (header row + data rows)
Dim totalRows As Integer = sheet.Rows.Count()
Console.WriteLine($"Rows in file: {totalRows}")

' Spot-check specific cell values
Dim header As String = sheet("A1").StringValue
Dim firstEmployee As String = sheet("A2").StringValue

Console.WriteLine($"Header: {header}, First row: {firstEmployee}")
$vbLabelText   $csharpLabel

這一驗證模式在整合測試中特別有用，當確認匯出正確性必須在將文件發送到外部系統之前完成時。 IronXL讀取教程展示了在載入文件後可用的所有讀取操作範圍。

有關DataSet和DataTable模式在.NET中的進一步閱讀，Microsoft DataSet文件從深度上涵蓋了ADO.NET物件模型。

您接下來的步驟是什麼？

您現在在C#中擁有每個主要的DataSet到Excel匯出情境的有效模式——從單個DataTable到多表工作簿、資料庫驅動的匯出、格式化標題和大型資料流。 以下是如何根據您的目標採取下一步：

  • 免費試用IronXL：首先使用免費試用授權，在承諾生產之前，對自己的資料運行上述範例。
  • 閱讀完整的API參考：IronXL物件參考涵蓋每個WorkBook、WorkSheet和單元範圍的方法。
  • 探索相關的匯出教程：C# DataTable轉Excel指南介紹了逆向工作流——將Excel讀回DataTable物件。
  • 複習格式選項：IronXL單元格式文件顯示數字格式、邊框、背景顏色和對齊選項。
  • 檢查授權：對於生產部署，請參閱IronXL授權頁面，在開發者、組織和免版稅選項中進行選擇。
  • 與其他Iron Software工具進行比較：如果您的專案還需要PDF生成或OCR功能，Iron Software產品套件讓您可以以較低的價格捆綁多個程式庫。

基於這裡介紹的模式，您可以完全用受管C#程式碼新增排程任務自動化、ASP.NET Core下載端點和多格式輸出管道——不需要Office，不需要COM，不需要除了NuGet包以外的執行時依賴。

常見問題

如何在C#中將DataSet導出至Excel？

您可以使用IronXL程式庫在C#中將DataSet導出至Excel，該程式庫提供了程式碼優先的API來建立、編輯並操作Excel文件，無需Microsoft Office。

我需要安裝Microsoft Office來使用IronXL嗎？

不需要，IronXL不需要Microsoft Office安裝在機器上即可匯出或操作Excel文件。

使用IronXL可以導出哪些型別的資料？

IronXL允許您將結構化資料如DataTables和DataSets導出至Excel文件，以及來自SqlDataReader和其他ADO.NET來源的資料。

IronXL可以處理Excel文件的建立和編輯嗎？

可以，IronXL提供功能以在C#中程式化建立、編輯和操作Excel文件。

IronXL適用於伺服器端及雲端應用嗎？

是的，IronXL非常適合需要生成Excel文件但不需安裝Office的伺服器端應用和雲端功能。

使用IronXL導出DataSets的好處是什麼？

IronXL可以在不依賴Microsoft Office等外部依賴的情況下建立和操作Excel文件，支持XLSX、XLS和CSV格式，並可以跨所有.NET目標框架工作。

IronXL可以在ASP.NET Core中用於返回Excel下載嗎？

是的，IronXL可以將工作簿保存到MemoryStream中，結果的位元組陣列可以從ASP.NET Core控制器動作中作為文件下載返回。

IronXL支持大型DataSets嗎？

是的，IronXL可以從SqlDataReader直接流式傳輸資料而不需緩衝完整的DataTable，保持大型結果集的記憶體使用可預測。

IronXL支持保存哪些Excel格式？

IronXL支持無需任何額外依賴保存至XLSX、XLS、CSV、TSV和JSON格式。

我可以在導出至Excel時應用如加粗標題之類的格式嗎？

可以，IronXL在單元格範圍上提供了一個Style API，用於加粗字體、背景顏色、邊框、數字格式和對齊。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

相關文章

30天試用→完整產品。無限制。無需信用卡。 開始免費試用

Iron 支援團隊

我們線上24小時，每週5天。
聊天
電子郵件
給我打電話