如何解决Excel-Dna中展示.NET POCO数组的#VALUE!错误？

嘿，这个问题我之前也踩过坑！Excel-Dna 默认没办法直接识别自定义的 Employee POCO 类型数组——它只懂怎么处理基础类型（比如 string、int、double）或者基础类型组成的数组，所以返回 object[] 能正常展示，但返回 Employee[] 就会抛出#VALUE!错误，核心原因是Excel-Dna不知道该把POCO的属性如何映射到Excel的单元格结构里。

下面给你两种实用的解决办法，按需选择：

方法1：手动转换为二维对象数组（最简单直接） #

既然Excel能识别基础类型的二维数组，我们可以把每个Employee实例的属性提取出来，拼成object[][]返回。这样Excel会自动把二维数组的每一行对应到Excel的行，每一列对应到单元格。

示例代码：

public static object[][] GetEmployees()
{
    var employees = new[]
    {
        new Employee { Name = "Alice", Age = 30, Salary = 80000, Address = "123 Main St" },
        new Employee { Name = "Bob", Age = 35, Salary = 95000, Address = "456 Oak Ave" }
    };

    // 转换为二维数组：每行对应一个Employee的属性
    return employees.Select(emp => new object[]
    {
        emp.Name,
        emp.Age,
        emp.Salary,
        emp.Address
    }).ToArray();
}

如果是异步方法GetEmployeeAsync，记得遵循Excel-Dna的异步UDF规范，用ExcelAsyncUtil.Run包装逻辑，在异步回调里返回转换后的二维数组即可。

方法2：自定义Excel数据转换器（更优雅，适合复用） #

如果你的POCO类型很多，不想每次都手动转换，可以实现Excel-Dna的IExcelDataConverter接口，告诉Excel-Dna如何处理Employee类型。

步骤如下：

1. 创建转换器类：

public class EmployeeExcelConverter : IExcelDataConverter
{
    public bool TryConvert(object value, ExcelDestination destination, out object result)
    {
        // 处理单个Employee实例
        if (value is Employee emp)
        {
            result = new object[] { emp.Name, emp.Age, emp.Salary, emp.Address };
            return true;
        }
        // 处理Employee数组
        else if (value is Employee[] empArray)
        {
            result = empArray.Select(e => new object[] { e.Name, e.Age, e.Salary, e.Address }).ToArray();
            return true;
        }

        // 不是目标类型，交给其他转换器处理
        result = null;
        return false;
    }

    // 其他接口方法默认实现即可
    public bool TryConvert(object value, Type targetType, out object result)
    {
        result = null;
        return false;
    }
}

2. 在Excel-Dna加载项中注册转换器：

public class AddIn : IExcelAddIn
{
    public void AutoOpen()
    {
        // 注册自定义转换器
        ExcelDataConverter.AddConverter(new EmployeeExcelConverter());
    }

    public void AutoClose()
    {
        // 按需清理资源
    }
}

3. 现在异步方法可以直接返回Employee[]了：

public static object GetEmployeeAsync()
{
    return ExcelAsyncUtil.Run("GetEmployeeAsync", null, async () =>
    {
        // 模拟异步获取数据
        await Task.Delay(1000);
        return new[]
        {
            new Employee { Name = "Charlie", Age = 28, Salary = 75000, Address = "789 Pine Rd" },
            new Employee { Name = "Diana", Age = 32, Salary = 88000, Address = "101 Cedar Ln" }
        };
    });
}

这样Excel-Dna会自动用你定义的转换器把Employee[]转换成Excel能识别的二维数组，正确展示在单元格中。

另外要注意：异步UDF必须返回object类型，且用ExcelAsyncUtil.Run包装异步逻辑，这是Excel-Dna处理异步的标准方式，否则也可能引发错误。

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