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

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

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

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

程序包管理器用户界面提供了一个浏览功能，用于显示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包管理器控制台以安装 CSV 解析库

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

Install-Package IronXL.Excel

包管理器控制台显示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 数据。 在输出文件中，双引号表示粗体值。

SaveAsCsv方法生成的CSV输出，以逗号分隔格式显示转换后的Excel数据。

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

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

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

图 8：示例 Excel 文件，演示了带有自动计算的库存数据结构，可以使用 C# CSV 库进行解析

接下来，我们将执行以下代码块，将IronXLXLS 文件转换为 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 文件。对于更复杂的场景，您可能需要在导出之前选择特定范围或对数据进行排序。

示例 CSV 文件在 WordPad 中打开，显示格式正确的逗号分隔数据，包含标题和多个产品条目

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

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

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

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

Microsoft Word 中显示的制表符分隔学生数据示例，展示了 TSV 文件的结构，其中包含姓名、电子邮件地址、学号 (R-NO) 和等级 (Grade) 列。

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是如何在保持数据结构不变的情况下，将制表符分隔的值正确转换为逗号分隔的值的：

示例 CSV 文件在 WordPad 中打开，显示学生记录，字段包括姓名、电子邮件、学号和成绩，以逗号分隔。