如何在 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 提供额外付费的无限制再分发安全保障。 如需了解更详细的定价信息，请访问此许可页面。