C# 怎么将 CSV 文件读取到 DataTable_C# CSV 文件读取 DataTable 方法

来源:这里教程网 时间:2026-02-21 17:30:01 作者:

在 C# 中将 CSV 文件读取到 DataTable 是一个常见的需求,尤其在处理数据导入、报表生成等场景中。下面介绍一种简单、实用的方法,使用 StreamReader 逐行读取 CSV 并填充到 DataTable。

1. 基本思路说明

CSV 文件本质上是文本文件,每行代表一条记录,字段之间用逗号(或其他分隔符)分隔。我们可以通过读取第一行作为列名,后续每一行作为数据行,动态构建 DataTable。

以下是一个完整的示例方法:

using System;
using System.Data;
using System.IO;
public static DataTable ReadCsvToDataTable(string filePath, bool hasHeader = true)
{
    DataTable dataTable = new DataTable();
    string[] lines = File.ReadAllLines(filePath, Encoding.UTF8);
    if (lines.Length == 0)
        return dataTable;
    // 解析列名(第一行为表头)
    string[] headers = lines[0].Split(',');
    foreach (string header in headers)
    {
        dataTable.Columns.Add(hasHeader ? header.Trim() : $"Column{dataTable.Columns.Count}");
    }
    // 从第2行开始读取数据
    int startRow = hasHeader ? 1 : 0;
    for (int i = startRow; i < lines.Length; i++)
    {
        string line = lines[i].Trim();
        if (string.IsNullOrEmpty(line)) continue;
        string[] data = line.Split(',');
        DataRow row = dataTable.NewRow();
        // 防止数据列数与列定义不匹配
        for (int j = 0; j < data.Length && j < headers.Length; j++)
        {
            row[j] = data[j].Trim();
        }
        dataTable.Rows.Add(row);
    }
    return dataTable;
}

2. 使用注意事项

上述方法适用于简单的 CSV 格式,但实际使用中需注意以下几点: 编码问题:确保文件编码为 UTF-8,否则中文可能出现乱码。可替换
Encoding.Default
或根据实际情况调整。
字段包含逗号:如果字段内容本身包含逗号(如 "Smith, John"),需要用引号包裹。上面的
Split(',')
无法正确处理,建议使用更健壮的库。
性能考虑:对于大文件,
File.ReadAllLines
会一次性加载全部内容到内存,可能影响性能。推荐使用
StreamReader.ReadLine()
逐行读取。

3. 推荐使用 CsvHelper(高级场景)

对于复杂 CSV 处理(如带引号字段、多分隔符、类型映射等),推荐使用开源库 CsvHelper

安装方式(NuGet):

Install-Package CsvHelper

示例代码:

```csharp using CsvHelper; using System.Globalization;

// 需要定义类映射,或使用 dynamic + DataTable 扩展 // CsvHelper 更适合映射到对象,但也可配合 DataTable 使用

<H3>4. 简化版 StreamReader 实现(适合大文件)</H3>
<font>避免内存溢出,适合读取较大的 CSV 文件:</font>
```csharp
public static DataTable ReadCsvViaStream(string filePath, bool hasHeader = true)
{
    DataTable table = new DataTable();
    using (var reader = new StreamReader(filePath, Encoding.UTF8))
    {
        string line;
        int lineNumber = 0;
        while ((line = reader.ReadLine()) != null)
        {
            if (lineNumber == 0)
            {
                string[] headers = line.Split(',');
                foreach (string h in headers)
                    table.Columns.Add(h.Trim());
                if (!hasHeader) AddDataRow(table, line.Split(','));
            }
            else if (hasHeader || lineNumber > 0)
            {
                AddDataRow(table, line.Split(','));
            }
            lineNumber++;
        }
    }
    return table;
}
private static void AddDataRow(DataTable table, string[] values)
{
    if (values.Length == 0) return;
    DataRow row = table.NewRow();
    for (int i = 0; i < values.Length && i < table.Columns.Count; i++)
    {
        row[i] = values[i].Trim();
    }
    table.Rows.Add(row);
}

基本上就这些。对于大多数简单场景,手动解析即可满足;若涉及复杂格式或大量数据,建议引入 CsvHelper 或其他专业库。

相关推荐