C# CSV库：使用IronXL完整教程

如何设置 C# 电子表格库？

通过NuGet安装IronXL只需不到一分钟。 在 Visual Studio 中打开程序包管理器控制台并运行以下命令，或者从任何终端使用.NET CLI：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

安装软件包后，将命名空间添加到任何需要处理电子表格数据的文件：

using IronXL;

using IronXL;

IronXL 的目标框架为.NET Framework 4.6.2+和所有现代.NET版本(Core、5、6、7、8、9 和 10)。 它可在 Windows、Linux 和 macOS 上运行，因此既适用于桌面工具，也适用于容器化服务器工作负载。 请访问IronXL安装指南，获取有关软件包来源和许可证激活的分步说明。

如何在C#中读取CSV文件？

使用IronXL读取 CSV 文件与加载任何电子表格遵循相同的模式。 调用 WorkBook.Load 并传入文件路径， IronXL会根据文件扩展名推断文件格式——无需额外配置：

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

WorkBook 对象公开了完整的电子表格模型。 您可以使用熟悉的 Excel 表示法(例如 "A2")访问单元格，内置的转换属性 -- DateTimeValue -- 可以处理类型强制转换，因此您不必手动解析字符串。

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

如何在C#中写入CSV文件？

从头开始创建 CSV 文件涉及三个步骤：创建 WorkBook，填充 WorkSheet，然后调用 SaveAsCsv。 该过程与构建任何电子表格的方式类似，从而保证了 AP​​I 的一致性，而与输出格式无关：

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

SaveAsCsv 处理分隔符放置、包含逗号的字段的引用以及换行符规范化。 您无需手动管理任何这些事项。 IronXL在导出过程中保留数值类型，以便 Excel 或 pandas 等下游工具将数字读取为数字，而不是读取为带引号的文本字符串。

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

如何在C#中实现CSV和Excel之间的转换？

IronXL最有价值的功能之一是 CSV 和 Excel 格式之间的双向转换。 该 API 是对称的 -- Load 可以读取任何受支持的格式，而 Save 系列方法可以将数据写入目标格式：

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

这些转换操作可以保持数据的完整性。 数值保持数值形式，日期字段保持其类型，公式结果在写入之前会计算出其计算值。 当您将多工作表 Excel 文件转换为 CSV 时， IronXL会自动为每个工作表创建一个单独的 CSV 文件：

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

这种行为对于下游用户期望每个文件对应一个主题的报告管道尤其有用。CSV写入教程还介绍了其他选项，例如指定分隔符以及控制导出中包含哪些工作表。

立即开始使用 IronXL。

免费开始

为什么仅支持 CSV 格式的库无法满足实际项目的需求？

许多 C# 开发人员从 Microsoft.VisualBasic 中的CsvHelper或TextFieldParser开始。 两者都是适用于仅处理 CSV 文件的工作流程的有效工具。 当需求扩大时，差距就会显现：利益相关者要求下载 Excel 文件而不是 CSV 文件，财务部门需要保留公式，或者安全策略要求对文件进行密码保护。 这时，仅支持 CSV 的库会迫使你添加第二个依赖项并维护两条独立的集成路径。 统一的电子表格库从一开始就消除了这种分裂。

下一步计划是什么？

IronXL为您提供一个统一的 API，用于在任何.NET 10 应用程序中读取、写入和转换 CSV 和 Excel 文件。 主要优势显而易见：不依赖 Office，支持跨平台，单元格值支持强类型，并且当需求发生变化时，可以直接从仅支持 CSV 的项目过渡到完整的电子表格功能。

当你准备深入研究时，从与你当前项目最相关的主题开始。 如果您主要处理 CSV 导入管道，那么上面介绍的读取和映射模式可以处理大多数实际场景。 如果您的输出要求有所不同——有时是下游脚本所需的 CSV 文件，有时是最终用户所需的 XLSX 文件——格式转换部分展示了如何使用单个代码库来同时满足这两种需求。

对于构建报告系统或从数据库导出结果的团队来说，InsertDataTable 方法具有良好的可扩展性，并且避免了逐行单元格分配带来的性能开销。 结合单元格样式，即可生成用户无需重新格式化即可在 Excel 中直接打开的报告。

要继续进行，请按照以下步骤操作：

1. 使用NuGet安装库Install-Package IronXL 或 dotnet add package IronXL。 2.按照IronXL入门指南中的快速入门步骤加载您的第一个 CSV 文件。
2. 当您需要在同一个项目中同时使用 CSV 和 Excel 格式时，请探索 CSV 到 Excel 格式转换教程。
3. 查看IronXL对象参考中的API 参考，了解高级单元格操作、公式支持和样式设置。
4. 在IronXL试用许可证页面开始免费试用——无需信用卡，包含技术支持。

如果您正在评估其他Iron Software工具的选项， IronSoftware 产品套件涵盖了使用IronPDF生成 PDF、条形码读取、OCR 等功能——所有这些都共享相同的许可模式和支持渠道。