如何在 C# 中將 `DataTable` 匯出為 CSV

IronXL Library 提供哪些功能？

使用 C# IronXL .NET庫可以讀取Microsoft Excel 文件並將其轉換為 CSV 檔案。 IronXL是一個獨立的.NET軟體庫，可以讀取各種電子表格格式。 它不依賴 Microsoft.Office.Interop.Excel，也不需要安裝 Microsoft Excel。

透過IronXL的用戶友好型 C# API ，您可以在.NET環境中快速讀取、修改和建立 Excel 電子表格檔案。 IronXL完全支援.NET Core、 .NET Framework 、Xamarin、行動平台、 Linux 、 macOS和Azure 。

• 領先的.NET Core和.NET Framework Excel 電子表格庫（適用於 C#）包括IronXL。
• 幾乎所有.NET Framework 版本都受支持，包括控制台應用程式、Windows 窗體應用程式和 Web 應用程式。
• IronXL可在 Windows、Linux 和 macOS 作業系統上運作。
• IronXL讓讀取 Excel 檔案變得簡單快速。
• IronXL支援多種 Excel 格式：XLSX、XLS、CSV、TSV、XLST 和 XLSM 檔案。
• IronXL可將檔案匯出為多種格式，包括 XLS、CSV、TSV、JSON 和 XML。
• IronXL可產生 Excel 計算結果並支援公式。
• IronXL支援 Excel 列資料格式，包括文字、數字、日期、貨幣和百分比。

更多詳情請瀏覽IronXL文件概述。

如何在 Visual Studio 中建立新專案？

在 Visual Studio 中，必須先建立一個.NET項目，然後才能使用IronXL框架。 任何版本的 Visual Studio 都可以使用，但建議使用最新版本。 根據您的需要，您可以建立 Windows 窗體應用程式或不同的專案範本。 為了簡單起見，本教學將使用控制台應用程式。

Visual Studio 的"建立新專案"對話方塊顯示了各種.NET專案模板，包括控制台應用程式、 ASP.NET Core Web 應用程式和Blazor伺服器應用程式選項。 在 Visual Studio 中建立一個新項目

之後，輸入項目名稱和地點。

配置新項目

接下來，選擇以下結構。 本專案將使用.NET Core 6。

選擇.NET Framework版本

應用程式產生解決方案後，將開啟 program.cs 文件，以便您可以輸入程式碼並建置/執行應用程式。

新建立的控制台應用程式項目

然後就可以新增該庫並使用它來評估程式碼。 對於其他項目類型，例如.NET MAUI應用程式或VB .NET項目，該過程類似，但需要考慮框架特定的因素。

如何安裝IronXL庫？

下載和安裝IronXL庫有四種方法。

其中包括：

• 透過 Visual Studio 安裝
• 使用 Visual Studio 套件管理器控制台進行安裝
• 直接從NuGet網站下載
• 直接從IronXL網站下載

如何將 DataTable 匯出到 CSV 檔案？

使用IronXL可以輕鬆快速地將 DataTables匯出到 CSV 檔案。 它支援自訂分隔符號和編碼選項，幫助將資料寫入新的 CSV 檔案。

首先，如下面的程式碼影像所示，應包含IronXL命名空間才能使用IronXL類別和方法。

新增通用命名空間

可以使用IronXL建立 Excel 文件，然後將其轉換為WorkBook物件。 然後對這些物件執行各種操作。 下面的範例程式碼將透過將 DataTable 轉換為 Excel 工作表來建立 Excel 檔案。

using IronXL;
using System.Data;

// Entry point of the application
static void Main(string[] args)
{
    // Specify the file path for the CSV file output
    ExportToExcel("H:\\test.csv");
}

// Exports the DataTable to an Excel file and saves it as CSV
public static void ExportToExcel(string filepath)
{
    // Create a DataTable and add columns and rows
    DataTable table = new DataTable();
    table.Columns.Add("DataSet_Fruits", typeof(string));
    table.Rows.Add("Apple");
    table.Rows.Add("Orange");
    table.Rows.Add("Strawberry");
    table.Rows.Add("Grapes");
    table.Rows.Add("Watermelon");
    table.Rows.Add("Bananas");
    table.Rows.Add("Lemons");

    // Create a new WorkBook and add the DataTable data to it
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);
    var writer = wb.DefaultWorkSheet;
    int rowCount = 1;
    foreach (DataRow row in table.Rows)
    {
        // Write each item from the DataTable into the worksheet starting from cell A1
        writer["A" + (rowCount)].Value = row[0].ToString();
        rowCount++;
    }
    // Save the workbook as a CSV file with a specified delimiter
    wb.SaveAsCsv(filepath, ";");
}

using IronXL;
using System.Data;

// Entry point of the application
static void Main(string[] args)
{
    // Specify the file path for the CSV file output
    ExportToExcel("H:\\test.csv");
}

// Exports the DataTable to an Excel file and saves it as CSV
public static void ExportToExcel(string filepath)
{
    // Create a DataTable and add columns and rows
    DataTable table = new DataTable();
    table.Columns.Add("DataSet_Fruits", typeof(string));
    table.Rows.Add("Apple");
    table.Rows.Add("Orange");
    table.Rows.Add("Strawberry");
    table.Rows.Add("Grapes");
    table.Rows.Add("Watermelon");
    table.Rows.Add("Bananas");
    table.Rows.Add("Lemons");

    // Create a new WorkBook and add the DataTable data to it
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);
    var writer = wb.DefaultWorkSheet;
    int rowCount = 1;
    foreach (DataRow row in table.Rows)
    {
        // Write each item from the DataTable into the worksheet starting from cell A1
        writer["A" + (rowCount)].Value = row[0].ToString();
        rowCount++;
    }
    // Save the workbook as a CSV file with a specified delimiter
    wb.SaveAsCsv(filepath, ";");
}

上述程式碼將 DataTable 匯出到 Excel 檔案。建立 DataTable 後，會自動建立列標題。 然後，在確定第一列之後，逐行新增後續行。 在向 DataTable 物件新增列和行以保存這些資料之後，建立 WorkBook 物件。 然後建構WorkSheet對象，並將其加入到 WorkBook 物件中。

使用 DataTable 循環讀取並新增 foreach 中的每個值，然後再將該值加到 WorkSheet 中。 將所有值加入工作表後， SaveAsCsv方法會將它們儲存到 CSV 檔案中。您可以將分隔符號和檔案位置都指定為參數。

對於更複雜的場景，您可能需要將多個資料表匯出為不同的工作表，或使用資料集進行更結構化的資料組織。

// Export with custom delimiter and encoding
public static void ExportToCSVWithOptions(DataTable dataTable, string filepath)
{
    // Create workbook from DataTable
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = wb.CreateWorkSheet("DataExport");

    // Add headers
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        ws[$"{(char)('A' + i)}1"].Value = dataTable.Columns[i].ColumnName;
    }

    // Add data rows
    for (int row = 0; row < dataTable.Rows.Count; row++)
    {
        for (int col = 0; col < dataTable.Columns.Count; col++)
        {
            ws[$"{(char)('A' + col)}{row + 2}"].Value = dataTable.Rows[row][col];
        }
    }

    // Save with custom delimiter (comma) and UTF-8 encoding
    wb.SaveAsCsv(filepath, ",", System.Text.Encoding.UTF8);
}

// Export with custom delimiter and encoding
public static void ExportToCSVWithOptions(DataTable dataTable, string filepath)
{
    // Create workbook from DataTable
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = wb.CreateWorkSheet("DataExport");

    // Add headers
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        ws[$"{(char)('A' + i)}1"].Value = dataTable.Columns[i].ColumnName;
    }

    // Add data rows
    for (int row = 0; row < dataTable.Rows.Count; row++)
    {
        for (int col = 0; col < dataTable.Columns.Count; col++)
        {
            ws[$"{(char)('A' + col)}{row + 2}"].Value = dataTable.Rows[row][col];
        }
    }

    // Save with custom delimiter (comma) and UTF-8 encoding
    wb.SaveAsCsv(filepath, ",", System.Text.Encoding.UTF8);
}

為什麼我應該使用IronXL進行 CSV 匯出？

IronXL是Excel中最受歡迎的工具之一。 它不依賴任何其他外部來源的函式庫。 它是獨立運作的，無需安裝微軟Excel。 它透過多個管道運作。

IronXL提供了一個一體化解決方案，以程式設計方式實現所有與 Microsoft Excel 文件相關的任務。 您可以執行公式計算、字串或數字排序、修剪和追加、尋找和取代、合併和取消合併、儲存檔案等操作。您也可以設定儲存格資料格式並驗證電子表格資料。 它還支援讀寫 CSV 文件，幫助您像處理 Excel 資料一樣處理資料。

其他福利包括：

• 敏感資料匯出密碼保護
• 針對大型資料集的效能最佳化
• 支援在匯出為 CSV 檔案之前在 Excel 中進行條件格式設定
• 支援命名範圍和命名表
• 以支援的格式保留超鏈接

IronXL 的上市起價為 $799。 它還為用戶提供支付一年訂閱費以獲得產品支援和更新的選項。 IronXL提供額外付費的無限再分送安全保障。 如需了解更詳細的定價信息，請訪問此許可頁面。