如何在 C# 中将 CSV 文件读取到 DataTable

为什么CSV转换为DataTable很重要？

CSV转为DataTable转换允许开发人员将逗号分隔值转化为结构化对象，以便进一步处理。 无论您是在处理库存数据、客户记录还是事务日志，快速有效地将CSV转换为DataTable是至关重要的。 使用第一行作为列标题，您可以确保DataTable列与您的数据库表架构对齐，为Excel到SQL操作提供完美的支持。

传统方法通常在处理大文件、不同分隔符或内存管理时遇到困难。 IronXL消除了这些挑战，能够处理不同的分隔符、引用字段和嵌入的逗号而无需额外代码。 IronXL的CSV读取功能消除了常见的痛点，同时提供数据验证和文件大小控制等额外功能。

如何安装IronXL？

开始使用IronXL只需简单的NuGet软件包安装。 在Visual Studio中打开NuGet包管理器控制台并执行以下命令之一：

Install-Package IronXL

Install-Package IronXL

或者如果您更喜欢.NET CLI：

dotnet add package IronXL

dotnet add package IronXL

安装完成后，将IronXL命名空间添加到您的项目中：

using IronXL;
using System.Data;

using IronXL;
using System.Data;

这提供了对所有CSV处理功能的访问，而不需要任何Excel依赖。 有关更多细节，请参阅IronXL文档和NuGet安装指南。

如何验证安装成功？

创建一个加载CSV文件的测试程序来验证安装。 如果遇到许可消息，您需要获取许可证密钥。 检查项目文件中的包引用，确保IronXL以正确的版本出现。 运行一个基本的CSV读取操作 —— 如果没有错误完成，您的安装就正常工作。

使用 NuGet 安装

PM >  Install-Package IronXL.Excel

在 IronXL 上查看 NuGet 快速安装。超过 1000 万次下载，它正以 C# 改变 PDF 开发。 您也可以下载 DLL。

如何将CSV文件转换为DataTable？

IronXL中的核心工作流程只需几行代码。 以下是在C# 10+中使用顶级语句读取CSV文件并将其转换为DataTable的方法：

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

LoadCSV方法自动解析您的CSV文件，处理引用字段和嵌入的逗号。 fileFormat参数告诉IronXL如何在内部解释CSV数据，确保将其视为Excel兼容结构。 加载后，true表明应使用首行作为列标题。 这将产生一个干净、结构化的DataTable，列名与您的CSV标题匹配。 对于更高级的操作选项，请浏览完整的IronXL操作指南。

转换过程还保留了数据类型 —— 数字保持数字，日期解析正确，文本字段保持其格式。 这种自动类型推断与手动解析方法相比节省了大量的开发时间。 对于需要自定义数据格式的场景，您可以在转换之前应用单元格格式化。

如何将DataTable导入到SQL Server？

一旦您获得了SqlBulkCopy导入到SQL Server中将变得高效。 以下示例使用C#顶级语句：

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

SqlBulkCopy类为大规模数据导入提供了强劲的性能。 DataTable列映射到具有不同名称的数据库列，确保您的数据架构灵活性。 BatchSize属性通过逐块处理记录而不是一次性加载所有内容，从而优化了内存使用。 了解更多关于IronXL的导入和导出功能。

为了提高数据完整性，考虑在大容量复制操作中实现事务支持。 这确保在发生错误时可以回滚部分导入。 您还可以使用IronXL的写Excel文件功能预先验证数据以进行导入。

在这里，您可以在SSMS中使用查询SELECT * FROM dbo.Inventory;检查您的CSV数据是否已导入到SQL Server中。 首先，看看示例CSV文件中使用的数据：

现在，如果查看查询的输出，您可以看到它成功地将每一列、标题和行复制到数据库表中。

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

并非所有CSV文件都使用逗号。 IronXL处理各种分隔符，使其适用于国际数据格式或旧版系统。 以下示例演示了加载制表符分隔文件和分号分隔文件：

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

此代码演示了将具有不同分隔符的CSV文件加载到IronXL WorkBook 对象中。 使用"\t"作为分隔符读取制表符分隔文件，而分号分隔文件在加载之前被转换为标准CSV格式。 每个工作簿的默认工作表转换为具有DataTable，使用首行作为列标题。 对于更复杂的文件格式场景，您还可以探索将Excel数据导出为各种格式。

处理不同分隔符的灵活性解决了许多现实世界中的CSV解析挑战。 在处理欧洲数据格式时，IronXL的分隔符处理适应不同地区的差异。 对于结构不统一的文件，在将其传递给LoadCSV之前进行预处理。

RFC 4180标准定义了IronXL遵循的CSV格式规范，用于引用字段和嵌入的逗号。 在Stack Overflow社区线程关于将CSV读取到.NET的DataTable中也详细讨论了这一灵活性。

IronXL支持的其他功能超过CSV

IronXL的功能远远不止CSV读取。 该库处理C#中的全面Excel和电子表格操作，成为数据中心应用的单一依赖。

下一步是什么？

IronXL将CSV数据库导入转换为一个简单且可靠的过程。 只需几行代码，您就可以：

• 通过LoadCSV功能从任何文件路径读取CSV文件
• 将CSV数据转换为具有适当数据格式化的DataTable
• 通过自动解析保留列标题和DataTable列
• 使用批量操作高效地将数百万行导入到数据库表中

该库处理CSV解析的复杂性、内存管理和数据类型转换，让您将重点放在业务逻辑上，而不是文件处理细节。 无论您是构建ASP.NET应用程序，使用Blazor，还是开发.NET 10桌面应用程序，IronXL为所有平台提供一致、可靠的CSV处理。

准备好开始了吗？ IronXL文档深入介绍了每个功能，并且试用许可证允许您评估完整的库。 通过丰富的代码示例和清晰的API参考，您将在.NET 10应用程序中迅速高效地处理CSV文件。