C#中如何配置Excel列与类属性的映射以避免硬编码？

你已经完成了配置读取和Excel数据到DataTable的转换，只需要基于配置的映射关系结合反射/表达式树即可实现动态赋值，无需硬编码列名。

步骤1：预处理映射配置 #

建议在程序启动/配置加载阶段，提前把配置的列和属性映射解析成可直接调用的结构，避免重复反射带来的性能损耗：

// 存储映射关系：key为Excel列名，value为对应类属性的反射对象
private Dictionary<string, PropertyInfo> _columnPropertyMap = new Dictionary<string, PropertyInfo>();

// 初始化阶段处理所有配置的映射
foreach (var mapping in 你读取到的配置ColumnMappings集合)
{
    // 拆分配置的类属性全限定名，得到类名和属性名
    string fullPropertyPath = mapping.ClassProperty;
    int lastDotIndex = fullPropertyPath.LastIndexOf('.');
    string className = fullPropertyPath.Substring(0, lastDotIndex);
    string propertyName = fullPropertyPath.Substring(lastDotIndex + 1);

    // 加载目标类型，若类型加载失败可补充自定义配置错误逻辑
    // 若Type.GetType返回null，可在配置的类名后补充程序集名，格式为：命名空间.类名, 程序集名称
    Type targetType = Type.GetType(className);
    if (targetType == null) continue;

    // 获取可写的属性信息
    PropertyInfo propInfo = targetType.GetProperty(propertyName);
    if (propInfo != null && propInfo.CanWrite)
    {
        _columnPropertyMap.Add(mapping.ColumnName, propInfo);
    }
}

步骤2：动态赋值类实例 #

遍历DataTable的行数据，基于预处理好的映射关系完成赋值：

List<MyClass> resultList = new List<MyClass>();
foreach (DataRow row in dataTable.Rows)
{
    // 动态创建类实例，若需支持多类映射，可调用Activator.CreateInstance(targetType)创建
    MyClass instance = new MyClass();

    foreach (var mapItem in _columnPropertyMap)
    {
        string excelCol = mapItem.Key;
        PropertyInfo prop = mapItem.Value;

        // 处理Excel空值情况
        object cellValue = row[excelCol] == DBNull.Value ? null : row[excelCol];
        if (cellValue == null) continue;

        // 自动适配属性类型做转换，无需手动ToString
        object convertedValue = Convert.ChangeType(cellValue, prop.PropertyType);
        prop.SetValue(instance, convertedValue);
    }

    resultList.Add(instance);
}

高性能优化方案（适用大数据量导入） #

如果单次导入的数据量超过1000行，直接反射的性能会有明显损耗，可以用表达式树把赋值逻辑编译成委托缓存，性能接近硬编码赋值：

// 定义赋值委托
private delegate void PropertySetter(object instance, object value);
// 缓存映射改为存储委托
private Dictionary<string, PropertySetter> _columnSetterMap = new Dictionary<string, PropertySetter>();

// 初始化阶段编译赋值委托
foreach (var mapping in 你读取到的配置ColumnMappings集合)
{
    // 拆分类名、属性名、获取PropertyInfo的逻辑和上面一致，此处省略
    // ...

    // 生成表达式树编译赋值委托
    ParameterExpression instanceParam = Expression.Parameter(typeof(object), "instance");
    ParameterExpression valueParam = Expression.Parameter(typeof(object), "value");

    UnaryExpression instanceCast = Expression.Convert(instanceParam, propInfo.DeclaringType);
    UnaryExpression valueCast = Expression.Convert(valueParam, propInfo.PropertyType);
    BinaryExpression assignExp = Expression.Assign(Expression.Property(instanceCast, propInfo), valueCast);

    PropertySetter setter = Expression.Lambda<PropertySetter>(assignExp, instanceParam, valueParam).Compile();
    _columnSetterMap.Add(mapping.ColumnName, setter);
}

// 赋值阶段直接调用委托
foreach (DataRow row in dataTable.Rows)
{
    MyClass instance = new MyClass();
    foreach (var mapItem in _columnSetterMap)
    {
        object cellValue = row[mapItem.Key] == DBNull.Value ? null : row[mapItem.Key];
        if (cellValue != null)
        {
            mapItem.Value(instance, cellValue);
        }
    }
    resultList.Add(instance);
}

额外适配方案 #

• 如果需要支持嵌套属性赋值（比如配置为MyNamespace.MyClass.SubObj.Property），只需要在预处理映射阶段逐级解析属性路径，构造嵌套对象的赋值逻辑即可。
• 可以在配置中扩展必填校验、格式规则等字段，在赋值前先做数据合法性校验，直接返回用户可理解的错误提示。

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