CsvHelper配置：子对象属性全为空时设为null

在CsvHelper 12.1.2中，默认使用References映射子对象时，即使所有字段为空，也会创建空实例而非null。要实现子对象全空时设为null，可以通过**手动转换（ConvertUsing）**替代References，在转换逻辑中判断子对象的所有字段是否为空，再决定返回实例还是null。

具体实现步骤 #

以Worker.Phone（对应HomePhoneNumber）为例，修改WorkerModelMap中的映射逻辑：

1. 移除原有的References<HomePhoneNumberModelMap>(x => x.Phone);
2. 替换为ConvertUsing，手动读取对应CSV字段并判断：

Map(x => x.Phone).ConvertUsing(row => 
{
    // 读取对应CSV列的值
    var areaCode = row.GetField("HomeAreaCode");
    var prefix = row.GetField("HomePrefix");
    var lineNumber = row.GetField("HomeLineNumber");

    // 判断所有字段是否为空/空白
    if (string.IsNullOrWhiteSpace(areaCode) && 
        string.IsNullOrWhiteSpace(prefix) && 
        string.IsNullOrWhiteSpace(lineNumber))
    {
        return null;
    }

    // 字段不全空时，创建并返回子对象实例
    return new PhoneNumber
    {
        AreaCode = areaCode,
        Prefix = prefix,
        LineNumber = lineNumber
    };
});

其他子对象的复用逻辑 #

对于BusinessTelephone、MobileTelephone、ResidentialAddress等其他子对象，只需复制上述逻辑，替换对应的CSV列名和子对象类型即可。例如处理ResidentialAddress：

Map(x => x.ResidentialAddress).ConvertUsing(row => 
{
    var street = row.GetField("ResidentialStreet");
    var city = row.GetField("ResidentialCity");
    var state = row.GetField("ResidentialState");
    var zip = row.GetField("ResidentialZip");

    if (string.IsNullOrWhiteSpace(street) && 
        string.IsNullOrWhiteSpace(city) && 
        string.IsNullOrWhiteSpace(state) && 
        string.IsNullOrWhiteSpace(zip))
    {
        return null;
    }

    return new ResidentialAddress
    {
        Street = street,
        City = city,
        State = state,
        Zip = zip
    };
});

为什么不使用References？ #

CsvHelper 12.1.2的References方法会自动实例化子对象，无论字段是否为空。通过ConvertUsing手动控制实例化逻辑，是这个版本下实现需求最直接的方式。

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