如何配置CsvHelper映射器，为CSV集合列名添加属性值前缀？

你要实现的这种把集合元素的属性值（比如MyCustom的Id）作为前缀生成CSV列名的需求，CsvHelper默认的映射规则确实没法直接满足——因为它默认会把集合里的每个元素拆成单独的行，而不是横向扩展列。不过我们可以通过手动控制表头生成和数据写入的方式来实现，下面是具体的实现步骤和代码示例：

1. 调整映射类 #

首先，我们先给MyClass的单个属性做基础映射，集合部分留到写入时手动处理：

public class MyClassMap : ClassMap<MyClass>
{
    public MyClassMap()
    {
        // 映射基础属性Property，对应表头的"Property"
        Map(m => m.Property).Name("Property");
        // 这里不直接映射MyCustoms集合，后续手动处理
    }
}

2. 手动生成表头与写入数据 #

接下来，我们需要在写入CSV时，先生成包含带前缀列名的表头，再逐行写入数据：

单个数据实例的情况 #

using (var writer = new StreamWriter("output.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    // 注册我们定义的映射类
    csv.Context.RegisterClassMap<MyClassMap>();
    
    // 模拟你的数据
    var myData = new MyClass
    {
        Property = "Title",
        MyCustoms = new List<MyCustom>
        {
            new MyCustom { Id = "123", Property2 = "John", Property3 = "Smith" },
            new MyCustom { Id = "456", Property2 = "Helen", Property3 = "Thomson" }
        }
    };

    // 第一步：生成表头
    // 先写入基础属性的表头
    csv.WriteHeader<MyClass>();
    // 遍历集合，生成带Id前缀的列名
    foreach (var custom in myData.MyCustoms)
    {
        csv.WriteField("Id"); // 每个MyCustom对应的Id列
        csv.WriteField($"{custom.Id}_Property2");
        csv.WriteField($"{custom.Id}_Property3");
    }
    // 写完表头换行
    csv.NextRecord();

    // 第二步：写入数据行
    // 先写入基础属性的数据
    csv.WriteRecord(myData);
    // 遍历集合，写入对应的数据
    foreach (var custom in myData.MyCustoms)
    {
        csv.WriteField(custom.Id);
        csv.WriteField(custom.Property2);
        csv.WriteField(custom.Property3);
    }
    // 写完数据换行
    csv.NextRecord();
}

多个数据实例的情况（通用场景） #

如果你的数据是一个List<MyClass>集合，要确保表头只生成一次，同时每个数据行都对应正确的列：

using (var writer = new StreamWriter("output.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.Context.RegisterClassMap<MyClassMap>();
    
    // 模拟多个数据实例
    var dataList = new List<MyClass>
    {
        new MyClass
        {
            Property = "Title",
            MyCustoms = new List<MyCustom>
            {
                new MyCustom { Id = "123", Property2 = "John", Property3 = "Smith" },
                new MyCustom { Id = "456", Property2 = "Helen", Property3 = "Thomson" }
            }
        },
        // 可以添加更多实例...
    };

    // 生成表头：取第一个实例的集合结构来生成列（假设所有实例的MyCustoms结构一致）
    csv.WriteHeader<MyClass>();
    var firstCustoms = dataList.First().MyCustoms;
    foreach (var custom in firstCustoms)
    {
        csv.WriteField("Id");
        csv.WriteField($"{custom.Id}_Property2");
        csv.WriteField($"{custom.Id}_Property3");
    }
    csv.NextRecord();

    // 逐个写入数据行
    foreach (var data in dataList)
    {
        csv.WriteRecord(data);
        foreach (var custom in data.MyCustoms)
        {
            csv.WriteField(custom.Id);
            csv.WriteField(custom.Property2);
            csv.WriteField(custom.Property3);
        }
        csv.NextRecord();
    }
}

3. 更通用的反射实现（避免硬编码属性名） #

如果MyCustom的属性可能变化，不想硬编码Property2、Property3，可以用反射自动获取属性：

// 获取MyCustom中除了Id之外的公共属性
var customProperties = typeof(MyCustom).GetProperties()
    .Where(p => p.Name != nameof(MyCustom.Id))
    .ToList();

// 生成表头时替换为：
foreach (var custom in firstCustoms)
{
    csv.WriteField("Id");
    foreach (var prop in customProperties)
    {
        csv.WriteField($"{custom.Id}_{prop.Name}");
    }
}

// 写入数据时替换为：
foreach (var custom in data.MyCustoms)
{
    csv.WriteField(custom.Id);
    foreach (var prop in customProperties)
    {
        csv.WriteField(prop.GetValue(custom));
    }
}

这样生成的CSV就完全符合你给出的示例格式了，表头会包含Property、Id、123_Property2、123_Property3、Id、456_Property2、456_Property3，数据行对应填充正确的值。

内容的提问来源于stack exchange，提问作者Maria