C# CSV 解析器（逐步教程）

我应该使用 Visual Studio NuGet 包管理器吗？

NuGet包管理器UI可用于在Visual Studio中将软件包直接安装到项目中。 对于喜欢可视化界面并希望在安装前查看软件包详细信息的开发人员来说，这种方法特别有用。 下面的截图显示了如何打开它。

Visual Studio 界面显示"工具"菜单已展开，"NuGet 包管理器"选项已高亮显示，并且二级菜单显示"管理解决方案的 NuGet 包"已选中。要访问 Visual Studio 中的 NuGet 包管理器，请导航至"工具">"NuGet 包管理器">"管理解决方案的 NuGet 包"。

程序包管理器用户界面提供了一个浏览功能，用于显示 NuGet 网站上可用的程序包库列表。输入"IronXL"（如下图所示）即可找到 IronXL 程序包。 您还可以探索 IronXL 提供的相关 Excel 处理功能。

Visual Studio 的 NuGet 包管理器界面显示了 IronXL.Excel 包的搜索结果，其中已选择版本 2022.9.9454 安装到名为"Create PDF"的 C# 项目中。 Visual Studio 中的 NuGet 包管理器显示了 IronXL.Excel 库，该库使开发人员能够在 .NET 应用程序中读取、生成和编辑 Excel 文件。 该软件包显示下载量已达 25 万次，版本为 2022.9.9454，可供安装。

选择IronXL.Excel程序包，然后单击"安装"按钮将其添加到项目中。 安装过程将自动处理所有依赖项，并配置您的项目以进行Excel 文件操作。

何时应该使用 Visual Studio 命令行？

在 Visual Studio 菜单中，转到"工具" > "NuGet 包管理器" >单击"包管理器控制台" 。 对于熟悉命令行界面或需要在构建脚本中自动化安装过程的开发人员来说，这种方法是更优的选择。

Visual Studio 界面显示"工具"菜单已展开，"NuGet 包管理器"选项已高亮显示，底部打开了"包管理器控制台"窗口。在 Visual Studio 中打开 NuGet 包管理器控制台以安装 CSV 解析库。

程序包管理器控制台将显示在屏幕底部。 输入以下命令并按回车键。 将安装IronXL。 当您需要安装特定版本或使用Azure或AWS 环境的部署脚本时，此方法特别有用。

Install-Package IronXL.Excel

Visual Studio 中的程序包管理器控制台显示 IronXL.Excel NuGet 程序包的安装过程，并显示下载成功的确认信息。程序包管理器控制台显示 IronXL.Excel 版本 2022.11.10251 已成功安装，并显示了程序包还原过程以及从 NuGet 存储库下载的确认信息。

如何将XLSX文件转换为CSV文件？

打开 Microsoft Excel 并创建一个新的 XLSX 文件。在文件的行和列中填充一些模拟数据。 在生产环境中，您可能需要使用 IronXL以编程方式创建 Excel 文件。 下图显示了本教程中所有转换所使用的文件。

图 6： Excel 示例数据，展示了一个简单的库存表，包含"物品"、"数量"、"价格"和"总计"四列，其中包含斧头、钢笔、充电器和耳机的数据。该示例数据展示了一个基本的库存结构，将用于演示 C# 中的 CSV 解析。

文件准备就绪后，编写以下示例代码并执行程序。 IronXL 在内部处理所有复杂的解析，包括正确处理特殊字符和数据类型：

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

执行完成后，将创建一个名为Parsed CSV.csv的新文件。 您可以使用任何您喜欢的编辑器或阅读器打开 CSV 文件。您还可以将 CSV 数据重新导入 Excel进行进一步处理。 下图显示了上述命令的输出结果——我们生成的 CSV 数据。 在输出文件中，双引号表示粗体值。

图 7：使用 WorkBook.SaveAsCsv方法生成的WorkBook输出，以逗号分隔格式显示SaveAsCsv后的 Excel 数据。

如何将 XLS 文件转换为 CSV 文件？

在这个例子中，我们将看到如何将 XLS 文件转换为 CSV 格式。 该过程与 XLSX 转换相同，这体现了 IronXL 在处理不同 Excel 文件格式方面的多功能性。

首先，我们创建一个示例 XLS 文件，然后将其转换为 CSV 格式。 请注意，XLS 是较旧的 Excel 格式，但 IronXL 可以无缝地处理它以及现代格式：

图 8为一个示例 Excel 文件，展示了库存清单，包含"物品"、"数量"、"价格"和"总计"四列，列出了斧头、笔、充电器、耳机和锯子等各种工具及其数量和计算出的总计，总计为 1239。该示例 Excel 文件演示了库存数据结构及其自动计算功能，可以使用 C# CSV 库进行解析。

接下来，我们将执行以下代码块，将示例 XLS 文件转换为 CSV 文件。IronXL 在转换过程中会保持数据完整性，包括公式和计算结果：

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

上述代码执行完毕后，您将得到一个新生成的 CSV 文件。对于更复杂的场景，您可能需要在导出之前选择特定范围或对数据进行排序。

! WordPad 窗口显示一个 CSV 文件，其中包含商品、数量、价格和总计，包括 AXE、钢笔、充电器、耳机和锯子的条目。示例 CSV 文件在WordPad中打开，显示格式正确的逗号分隔数据，带有标题和多个产品条目。

如何从 TSV 格式解析 CSV 文件？

电子表格应用程序经常使用 TSV 文件（制表符分隔值文件）在数据库之间传输数据。 它会保存一个数据表，数据列之间用制表符分隔，每条记录占一行。当数据中包含可能干扰 CSV 解析的逗号时，TSV 文件尤其有用。

IronXL 提供了一个 CSV 解析器，用于将 TSV 格式的文件解析为 CSV 文件，以便更好地进行数据管理。 转换过程简单直接，并能始终保持数据完整性。

让我们从例子开始。 首先，我们将创建一个包含学生数据的TSV文件：

！ Microsoft Word 文档，显示一个包含学生数据的表格，数据包括姓名、电子邮件地址、学号 (R-NO) 和字母等级，格式为制表符分隔值 (TSV)。示例：在 Microsoft Word 中显示的制表符分隔的学生数据，展示了 TSV 文件的结构，其中包含姓名、电子邮件地址、学号和等级列。

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

以下是CSV格式的输出结果。 请注意 IronXL 是如何在保持数据结构不变的情况下，将制表符分隔的值正确转换为逗号分隔的值的：

! WordPad 文档显示了一个 CSV 文件，其中包含学生数据，包括姓名、电子邮件、学号和成绩，并以逗号作为分隔符。示例 CSV 文件在WordPad中打开，显示了学生记录，其中包含姓名、电子邮件、学号和成绩字段，字段之间以逗号分隔。