使用 IronXL 将 C# 保存为 CSV

逗号分隔值简介

逗号分隔值 (CSV) 文件是在不同应用程序之间存储和交换表格数据最广泛使用的格式之一。 CSV 文件最简单的形式是一个纯文本文件，每一行都包含一系列用逗号分隔的值。 这种简单明了的结构使 CSV 数据易于在各种软件系统中生成、读取和处理。 CSV 格式既轻便又便于人类阅读，因此是导出报告、在数据库之间传输数据以及与分析工具集成的热门选择。

了解 CSV 格式

CSV 格式设计简单：CSV 文件中的每一行代表一条记录，该行中的每个值用逗号分隔。 文件的第一行通常作为标题，列出每一列的名称。 随后的每一行都包含实际数据，每个值对应标题中的一列。 这种结构允许 CSV 文件以易于阅读和解析的格式来表示复杂的数据表。

如何在我的项目中安装 IronXL？ 通过 NuGet 软件包（微软的 .NET 软件包管理器）将 IronXL 添加到新项目中只需几秒钟。 打开 Visual Studio，然后访问 NuGet 包管理器控制台并运行以下命令： ```shell :ProductInstall ``` !a href="/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-1.webp">C# 使用 IronXL 保存为 CSV：图片 1 - 安装。 或者，右键单击解决方案资源管理器中的项目，选择 "管理 NuGet 包"，在浏览选项卡中搜索 "IronXL"，然后单击安装。 IronXL 支持 [.NET Framework 4.6.2+、.NET Core、.NET 5/6/7/8](/csharp/excel/docs/)，可在任何平台上运行，无外部依赖性或 COM 互操作要求。 安装完成后，使用 `using` 语句将 IronXL 命名空间添加到代码文件中： ```cs using IronXL; ``` 该单一命名空间可访问电子表格创建和 CSV 导出操作所需的所有类。 与依赖 `StreamWriter` 类或 `StringBuilder` 手工编写 CSV 文件的方法不同，IronXL 可自动处理正确 CSV 格式化的所有复杂问题。

如何从零开始创建新的 CSV 文件？ 以编程方式创建新的 CSV 文件包括三个简单明了的步骤：创建工作簿、填充数据并将其保存为 CSV 格式。 IronXL.Excel 直观的 API 反映了人们熟悉的 Excel 对象模型，使开发人员可以轻松编写代码，在控制台应用程序或任何 .NET 项目类型中使用电子表格概念。 假设您需要将员工对象列表导出为 CSV。下面是一个完整的示例，展示了如何编写 CSV 数据： ```cs using IronXL; class Program { public static void Main(string[] args) { // Create a new workbook and worksheet WorkBook workBook = WorkBook.Create(); WorkSheet sheet = workBook.CreateWorkSheet("Employees"); // Add header row with column names sheet["A1"].Value = "EmployeeID"; sheet["B1"].Value = "Name"; sheet["C1"].Value = "Department"; sheet["D1"].Value = "Salary"; // Add employee data rows sheet["A2"].Value = 1001; sheet["B2"].Value = "Sarah Johnson"; sheet["C2"].Value = "Engineering"; sheet["D2"].Value = 85000; sheet["A3"].Value = 1002; sheet["B3"].Value = "Michael Chen"; sheet["C3"].Value = "Marketing"; sheet["D3"].Value = 72000; sheet["A4"].Value = 1003; sheet["B4"].Value = "Emily Rodriguez"; sheet["C4"].Value = "Finance"; sheet["D4"].Value = 91000; // Save as CSV file - output goes to the specified path workBook.SaveAsCsv("employees.csv", ","); } } ``` `WorkBook.Create()` 方法完全在内存中初始化一个新的电子表格，在最终保存操作之前不需要任何临时文件或磁盘 I/O。 `CreateWorkSheet()`方法将一个命名的工作表添加到工作簿中--在以后将多表工作簿导出为 CSV 时，该名称将变得非常重要。 ### 输出 !a href="/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-2.webp">C# 使用 IronXL 保存为 CSV：图片 2 - CSV 输出。 单元格引用（如 `sheet["A1"]` ）提供了对可赋值的特定单元格的直接访问。 IronXL 接受各种数据类型，包括字符串、整数、小数、日期和布尔值，可自动处理每种类型的适当格式。 对于更复杂的数据录入场景，请探讨如何使用 Excel 范围和批量操作。 [SaveAsCsv()](/csharp/excel/how-to/csharp-write-to-csv-file/) 方法将工作表 CSV 内容导出到文件。第一个参数指定输出文件名和路径，第二个参数定义分隔符。 IronXL 会自动处理适当的格式，包括转义特殊字符，否则可能会破坏 CSV 解析，并在整个导出过程中保持数据的完整性。

如何将对象列表导出为 CSV？ 在处理强类型对象时，您可以使用 `foreach` 循环遍历新列表并将每个项目写入工作表。 下面是一个带有公共字符串属性的 Student 类的示例： ```cs using IronXL; // Define the Student class with public string properties public class Student { public string FirstName { get; set; } public string LastName { get; set; } public string Email { get; set; } } // In your program class or method var students = new List { new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" }, new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" } }; WorkBook workBook = WorkBook.Create(); WorkSheet sheet = workBook.DefaultWorkSheet; // Add header row sheet["A1"].Value = "FirstName"; sheet["B1"].Value = "LastName"; sheet["C1"].Value = "Email"; // Use foreach to iterate through the list and write each item int row = 2; foreach (var item in students) { sheet[$"A{row}"].Value = item.FirstName; sheet[$"B{row}"].Value = item.LastName; sheet[$"C{row}"].Value = item.Email; row++; } workBook.SaveAsCsv("students.csv", ","); ``` 该模式演示了如何通过迭代每个项目并将其属性映射到特定列，将列表对象导出为 CSV 数据。 `foreach` 循环处理集合中的每个学生，并通过字符串插值动态构建单元格引用。

如何将现有 Excel 文件转换为 CSV？ 将 Excel 电子表格转换为 CSV 格式是与传统系统集成、为数据库导入准备数据或从人工创建的报告生成机器可读输出时的常见要求。 IronXL 在保持数据准确性的同时，以最少的代码完成了这一转换。 文件存在磁盘上，可直接加载。 ```cs using IronXL; // Load an existing Excel file from the specified location WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx"); // Convert and save as CSV format workBook.SaveAsCsv("Monthly_Report_20251012.csv"); ``` `Load()` 方法可打开各种格式的 Excel 文件，包括 XLSX、XLS、XLSM，甚至现有的 CSV 或 TSV 文件。 这种灵活性意味着开发人员可以建立标准化的导出管道，接受任何原始格式的输入文件。 系统内部处理文件操作。 ### 输入 !a href="/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-3.webp">C# 使用 IronXL 保存为 CSV：图片 3 - Excel 输入示例。 ### 输出 !a href="/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-4.webp">C# 使用 IronXL 保存为 CSV：图片 4 - Excel 至 CSV 输出。 IronXL 在转换过程中的一个突出功能是自动公式评估。 保存为 CSV 时，IronXL 会计算电子表格中存在的任何公式，并导出结果值而不是公式文本。 例如，包含 `=SUM(A1:A10)` 的单元格将作为计算总数导出，以确保 CSV 文件包含下游系统可立即使用的可操作数据。

多表导出如何工作？ 在处理包含多个工作表的 Excel 工作簿时，IronXL.Excel 会自动为每个工作表创建单独的 CSV 文件。 这种功能对于财务报告、地区销售数据，或在单个主工作簿中每个部门或类别都有自己的工作表的任何情况下都特别有价值。 ```cs using IronXL; // Load a multi-sheet workbook (e.g., annual sales by region) WorkBook workBook = WorkBook.Load("annual_sales.xlsx"); // Export all sheets to CSV - creates separate files for each workBook.SaveAsCsv("sales_export.csv"); // Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc. // Or export a specific worksheet WorkSheet northRegion = workBook.GetWorkSheet("North"); northRegion.SaveAsCsv("north_region_sales.csv"); ``` 命名约定将每个工作表的名称附加到基本文件名上，这样在处理或存档时就可以很容易地识别每个导出文件的来源。 对于只需要特定工作表的定向导出，可使用 `GetWorkSheet()` 检索所需的工作表，然后直接在该工作表对象上调用 `SaveAsCsv()` 。 在 IronXL 文档中了解有关 [ Excel 格式间转换](/csharp/excel/how-to/csharp-convert-xlsx-to-csv/)的更多信息。

如何将数据表导出为 CSV？ 企业应用程序经常使用从数据库查询、API 响应或内存数据处理中填充的 `DataTable` 对象。 IronXL for .NET 在这些 .NET 数据结构和文件导出之间架起了一座桥梁，提供了从应用程序内存到可共享 CSV 文件的可靠路径。 与使用 `var` 写入器方法或使用新的 `StreamWriter` 手动编写 CSV 文件相比，这种方法更加稳健。 ```cs using IronXL; using System.Data; // Create and populate a DataTable with columns DataTable products = new DataTable(); products.Columns.Add("SKU", typeof(string)); products.Columns.Add("ProductName", typeof(string)); products.Columns.Add("Price", typeof(decimal)); products.Columns.Add("InStock", typeof(int)); // Add rows of data products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150); products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75); products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200); // Create workbook and transfer DataTable contents WorkBook workBook = WorkBook.Create(); WorkSheet sheet = workBook.DefaultWorkSheet; // Add header row from column names for (int col = 0; col < products.Columns.Count; col++) { sheet.SetCellValue(0, col, products.Columns[col].ColumnName); } // Add data rows using a loop for (int row = 0; row < products.Rows.Count; row++) { for (int col = 0; col < products.Columns.Count; col++) { sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString()); } } // Export to CSV and save to the specified path workBook.SaveAsCsv("product_inventory.csv", ","); ``` 该模式遍历 `DataTable` 结构，首先传输列标题，然后系统地填充每一行数据。 `DefaultWorkSheet` 属性可快速访问新建工作簿中的第一个工作表，从而消除了在简单场景中创建显式工作表的需要。 默认情况下，该方法按顺序处理所有行。 ### 输出 !a href="/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-5.webp">C# 使用 IronXL 保存为 CSV：图片 5 - DataTable 到 CSV 输出。 IronXL 在传输过程中会保留数据类型，确保数值保持精确，日期保留格式。 这种方法适用于任何大小的[数据表](/csharp/excel/how-to/csharp-datable-to-csv/)，无论是包含来自简单查找查询的数十行记录，还是来自综合数据导出的数千条记录。 有关导出前的其他电子表格操作，请探索单元格格式化选项和[范围操作](/csharp/excel/tutorials/how-to-read-excel-file-csharp/)。

如何处理 CSV 文件中的自定义分隔符？ 不同的系统和地区标准需要不同的分隔符。 虽然逗号是许多国家的标准分隔符，但在欧洲地区，逗号通常用作数值的小数分隔符，因此欧洲人更喜欢使用分号。 当源数据的字段值中包含逗号时，Tab-separated 文件 (TSV) 很受欢迎。 IronXL 的`SaveAsCsv()`方法可满足所有这些情况，而无需额外代码来处理每一行输出。 ```cs using IronXL; WorkBook workBook = WorkBook.Load("data.xlsx"); // Standard comma delimiter (default format) workBook.SaveAsCsv("output_comma.csv", ","); // Semicolon delimiter (common in European systems) workBook.SaveAsCsv("output_semicolon.csv", ";"); // Tab delimiter (TSV format) workBook.SaveAsCsv("output_tab.tsv", "\t"); // Pipe delimiter (used in some data interchange formats) workBook.SaveAsCsv("output_pipe.csv", "|"); ``` `SaveAsCsv()`的第二个参数可接受任何字符串作为分隔符，从而提供了与不同系统和地区要求集成的完全灵活性。 在生成用于国际分发的文件时，要考虑目标系统的本地化期望--欧洲的金融系统通常希望使用分号分隔，而北美的系统通常默认使用逗号。 ## 最佳实践 在使用 C# 处理 CSV 文件时，遵循最佳实践可确保您的数据保持准确、可读，并与其他系统兼容。 以下是一些基本准则： * 一致的分隔符：在整个 CSV 文件中始终使用一致的分隔符，如逗号或分号。这有助于防止在导入或导出数据时出现解析错误。 * 引用特殊值：如果您的数据值包含逗号、引号或其他特殊字符，请用双引号括起来，以保持 CSV 数据的完整性。 * 日期和时间格式：在 CSV 文件中使用统一的日期和时间格式，以避免混淆并确保与其他应用程序的兼容性。 * 避免在数值中使用换行符：避免在值中包含换行符，因为换行符会破坏行结构并导致格式问题。 * 利用库：利用 CsvHelper 等库来简化 CSV 文件的读写。 CsvHelper 可以处理 CSV 格式的许多复杂问题，如转义、引号和自定义分隔符。 * 文件处理：在写入之前始终检查文件是否存在，并优雅地处理异常。 使用 `using` 语句确保文件流在使用后被正确关闭和处理。 例如，您可以在 Visual Studio 中启动一个新项目，安装 CsvHelper NuGet 软件包，并使用 `CsvWriter` 类将数据写入 CSV 文件。定义一个具有 "名 "和 "姓 "等属性的 Student 类，然后使用 `CsvWriter` 将 Student 对象列表导出到 CSV 文件。 这种方法不仅简化了您的工作流程，还降低了出错风险，确保您的 CSV 文件结构合理，可在任何应用程序中使用。 ## 结论 有了 IronXL，用 C# 创建和导出 CSV 文件变得异常高效。 从生成填充了结构化数据的新文件到转换复杂的多表 Excel 工作簿，该库提供了一个简洁、直观的 API，可处理适当的 CSV 格式化、特殊字符转义和公式评估等底层复杂问题。 与需要使用 `var stream` 和 `var csv` 变量或附加文本逻辑编写自定义代码的手动方法不同，IronXL 简化了整个过程。 本职位涉及的主要方法和技巧包括 * <代码>WorkBook.Create()用于在内存中初始化新的电子表格 * <代码>WorkBook.Load()用于打开任何支持格式的现有 Excel 文件 * <代码>SaveAsCsv()用于导出带有自定义分隔符的数据 * 使用 `GetWorkSheet()` 导出单个工作表，以便进行有针对性的转换 * 数据库到 CSV 工作流的 DataTable 迭代模式 * 使用 `foreach` 循环导出对象列表 [开始免费试用](trial-license)，探索电子表格的全部功能，或[购买许可证](/csharp/excel/licensing/)进行生产部署。 有关涵盖单元格样式、公式创建和图表生成等高级应用场景的其他示例，请浏览全面的 [IronXL 文档](/csharp/excel/docs/)和 [ 代码示例](/csharp/excel/examples/convert-excel-spreadsheet/)库。