C# WinForms中如何利用Excel表头动态创建类/对象

一、选对Excel操作库 #

别用Office COM组件（依赖本地Office安装，容易出兼容性问题），优先用轻量第三方库：

• EPPlus：适配.xlsx/.xlsm格式，非商业场景免费，直接通过NuGet安装EPPlus包
• NPOI：同时支持.xls和.xlsx，开源免费，NuGet安装NPOI包即可

二、先定义业务实体类 #

根据Excel表头字段，创建对应的实体类。比如Excel有「姓名」「年龄」「邮箱」三列，实体类写法如下：

public class UserInfo
{
    public string Name { get; set; }
    public int Age { get; set; }
    public string Email { get; set; }
}

三、核心：Excel数据到对象属性的映射 #

方案1：手动映射（适合简单场景） #

直接按列索引对应属性，逻辑直观，适合字段少的情况：

// 示例用EPPlus，NPOI逻辑类似
using (var package = new ExcelPackage(new FileInfo("用户选择的Excel路径.xlsx")))
{
    var worksheet = package.Workbook.Worksheets[0]; // 取第一个工作表
    int totalRows = worksheet.Dimension.Rows;
    var userList = new List<UserInfo>();

    // 跳过表头行（假设第一行是表头）
    for (int row = 2; row <= totalRows; row++)
    {
        var user = new UserInfo();
        // 按Excel列的位置赋值，第1列=姓名，第2列=年龄，第3列=邮箱
        user.Name = worksheet.Cells[row, 1].Value?.ToString();
        // 数值类型要做转换校验，避免空值报错
        if (int.TryParse(worksheet.Cells[row, 2].Value?.ToString(), out int age))
        {
            user.Age = age;
        }
        user.Email = worksheet.Cells[row, 3].Value?.ToString();
        
        userList.Add(user);
    }
    // 后续可将userList绑定到DataGridView等控件
}

方案2：特性+反射映射（适合多实体/复杂场景） #

给实体类属性加自定义特性标记对应Excel表头，用反射自动映射，减少重复代码：

1. 先定义自定义特性：

[AttributeUsage(AttributeTargets.Property)]
public class ExcelColumnAttribute : Attribute
{
    public string ColumnName { get; }
    public ExcelColumnAttribute(string columnName)
    {
        ColumnName = columnName;
    }
}

2. 给实体类属性标记特性：

public class UserInfo
{
    [ExcelColumn("姓名")]
    public string Name { get; set; }
    
    [ExcelColumn("年龄")]
    public int Age { get; set; }
    
    [ExcelColumn("邮箱")]
    public string Email { get; set; }
}

3. 反射映射逻辑：

using (var package = new ExcelPackage(new FileInfo("用户选择的Excel路径.xlsx")))
{
    var worksheet = package.Workbook.Worksheets[0];
    int totalRows = worksheet.Dimension.Rows;
    // 读取表头行，存为列表
    var headerList = worksheet.Cells[1, 1, 1, worksheet.Dimension.Columns]
                              .Select(cell => cell.Value?.ToString())
                              .ToList();
    var userList = new List<UserInfo>();

    for (int row = 2; row <= totalRows; row++)
    {
        var user = Activator.CreateInstance<UserInfo>();
        // 遍历实体类所有属性
        foreach (var prop in typeof(UserInfo).GetProperties())
        {
            var columnAttr = prop.GetCustomAttribute<ExcelColumnAttribute>();
            if (columnAttr == null) continue;
            
            // 找到表头对应的列索引（Excel列从1开始）
            int colIndex = headerList.IndexOf(columnAttr.ColumnName) + 1;
            if (colIndex <= 0) continue;
            
            var cellValue = worksheet.Cells[row, colIndex].Value;
            if (cellValue == null) continue;
            
            // 根据属性类型做转换赋值
            if (prop.PropertyType == typeof(int) && int.TryParse(cellValue.ToString(), out int intVal))
            {
                prop.SetValue(user, intVal);
            }
            else if (prop.PropertyType == typeof(string))
            {
                prop.SetValue(user, cellValue.ToString());
            }
            // 可扩展支持DateTime、decimal等更多类型的转换
        }
        userList.Add(user);
    }
}

四、WinForms集成注意点 #

• 文件路径：用OpenFileDialog让用户选择Excel文件，避免硬编码路径
• 异常处理：加try-catch捕获文件不存在、格式错误、类型转换失败等异常，给用户弹出提示框
• 性能优化：如果Excel数据量超大，建议分批读取，避免内存占用过高

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