如何使用IronXL在 C# 中快速读取 CSV 文件？

如何使用IronXL在 C# 中快速读取 CSV 文件？

使用IronXL （一个.NET库）在 C# 中快速读取 CSV 文件非常简单，只需几行代码即可将逗号分隔的数据转换为可查询的工作簿。 调用 WorkBook.LoadCSV，访问您的工作表，并开始遍历行——无需 StreamReader 样板代码、无需手动拆分逻辑，也无需安装 Office。

如何安装IronXL以开始使用？

在加载任何 CSV 数据之前，请通过NuGet将IronXL添加到您的项目中。 打开项目目录中的包管理器控制台或终端，然后运行以下命令之一：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

安装完成后，在要读取或写入 CSV 数据的任何文件的顶部添加 using IronXL;。 IronXL面向.NET 10 及所有现代.NET版本，因此无需额外的运行时配置。 该软件包包含所有必需的组件——无需单独的本地二进制文件、平台 SDK 或配置文件。 您可以通过检查项目文件中的 <PackageReference Include="IronXL" .../> 条目来验证安装是否成功。

要快速了解该库除了处理 CSV 文件之外还能做什么，请参阅IronXL功能页面和NuGet包列表。

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

读取 CSV 数据的最快途径是从 WorkBook.LoadCSV 方法开始。 一次调用即可处理文件加载、解析每一行，并返回一个功能齐全的工作簿对象，可供数据访问——这与手动创建 StreamReader 并自行处理每一行截然不同。

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", file翻译格式: ExcelFile翻译格式.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", file翻译格式: ExcelFile翻译格式.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

LoadCSV 方法接受文件名和可选的格式规范，自动检测逗号分隔符并将每个字段值解析到相应的单元格中。 解析器默认将第一行视为标题数据，从而可以直接通过名称访问列名。

如何处理不同的CSV分隔符？

现实世界中的 CSV 文件很少遵循单一的标准。 欧洲系统通常使用分号作为分隔符(因为逗号可作为小数分隔符)，而制表符分隔值 (TSV) 文件在科学和传统应用程序中很常见。 IronXL通过 listDelimiter 参数处理这些变化，支持任何字符或字符串作为分隔符。

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    file翻译格式: ExcelFile翻译格式.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    file翻译格式: ExcelFile翻译格式.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    file翻译格式: ExcelFile翻译格式.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    file翻译格式: ExcelFile翻译格式.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    file翻译格式: ExcelFile翻译格式.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    file翻译格式: ExcelFile翻译格式.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

listDelimiter 参数接受任何字符串值，几乎可以灵活地使用任何分隔符或序列。 一旦加载，无论原始文件格式如何，都可以通过相同的 API 访问数据，从而为不同数据源创造一致的开发体验。

如何将CSV数据转换为DataTable？

数据库操作经常需要 DataTable 格式的 CSV 数据，以便进行批量插入、LINQ 查询或绑定到数据感知控件。 ToDataTable 方法只需一次调用即可将工作表数据直接转换为 System.Data.DataTable 对象，无需手动创建列表或数组结构。

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

ToDataTable 方法会自动将工作表列映射到 DataTable 列。 当 useFirstRowAsColumnHeaders 设置为 true 时，第一行的值将变为列名，从而可以通过名称而不是索引访问字段。 DataTable 可直接与 SqlBulkCopy 集成，实现高性能 SQL Server 插入；或者，它可以绑定到 DataGridView 控件，以便立即进行可视化。

转换时尽可能保留数据类型，IronXL 会根据底层单元格值推断数字、日期和文本类型。 这种自动类型推断减少了处理原始 CSV 字符串时通常需要的手动解析。 熟悉的 DataTable API 意味着处理数据库查询结果的现有代码无需修改即可处理 CSV 数据——这在迁移项目中可以节省大量时间。

如何将CSV文件转换为Excel格式？

IronXL 的主要功能之一是 CSV 和 Excel 文件之间的格式转换。 CSV 数据可以通过格式设置、公式和多个工作表进行增强，然后保存为合适的 Excel 工作簿——所有这些都可以在同一个代码库中完成。 要深入了解单元格样式选项和公式编辑，请参阅IronXL文档，其中详细介绍了每个功能。

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

SaveAs 方法根据文件扩展名确定输出格式，支持 XLSX、XLS、CSV、TSV、JSON 和 XML 导出。 这种灵活性意味着单个导入过程可以为多个输出渠道提供数据——例如，为管理层生成 Excel 报告，为下游系统生成 CSV 提取文件。 背景和图案颜色指南展示了所有可用的样式选项。

如何高效处理大型 CSV 文件？

处理包含数十万行数据的 CSV 文件需要周密的内存管理。 IronXL提供处理大型数据集的实用方法，同时保持简单易用的 API。 建议采用分批处理数据的方式，而不是同时加载和转换每个记录，这样可以控制活动内存的使用情况。

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

这种批处理模式可以系统地处理大型文件，而无需同时处理每条记录。 范围选择语法($"A{i}:Z{endRow}")可高效访问特定行范围。

如何跨平台运行 CSV 处理？

现代.NET开发跨越多个部署环境——Windows 服务器、Linux 容器、macOS 开发机器和云平台。 IronXL 可在所有这些环境中一致运行，无需特定平台的代码路径或条件编译。

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// 平台-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.平台}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFile翻译格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// 平台-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.平台}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

同一个二进制软件包可以在不同的操作系统和部署模型上运行。 下表总结了支持的平台：

这种跨平台功能消除了代码从开发环境迁移到测试环境再到生产环境时出现的"在我的机器上运行正常"的问题。 在 Windows 工作站上开发的 CSV 处理程序无需修改即可部署到 Linux Docker 容器上。 有关部署配置指南， Microsoft .NET部署文档涵盖了每个平台的发布策略。

下一步计划是什么？

在 C# 中读取 CSV 文件不需要为了性能而牺牲代码清晰度，也不需要处理复杂的配置。 IronXL提供一致的 API，可自动处理解析、类型转换和数据访问，支持从简单的逗号分隔导出到欧洲分号分隔格式和制表符分隔的科学数据等各种现实世界的 CSV 变体。

要在生产环境中开始使用IronXL ，请购买IronXL许可证以解锁所有功能，包括优先支持、一年的更新和免版税部署。 我们为个人开发者、小型团队和企业项目提供不同的定价方案。

如果您想在购买前评估IronXL ，免费试用许可证可以让您在评估期间测试所有功能，而不会出现水印或行数限制。 IronXL教程库提供了涵盖常见CSV和Excel场景的指导性示例。

对于特定用例（例如处理加密 CSV 文件、处理非标准编码或与云存储提供商集成）方面的问题， Iron Software支持团队和社区论坛可提供帮助。Microsoft Learn提供的其他.NET数据处理资源可提供有关文件输入/输出模式的补充信息，这些模式与IronXL配合使用效果更佳。