ExcelDNA插件开发：数组多行列显示及异步方法异常排查

我来帮你拆解遇到的两个核心问题：为什么返回的数组只显示第一个元素，以及异步方法中抛出XlCallException的修复方案。

一、让数组自动填充多行/多列的关键 #

你的初始StringSplit函数返回的是一维数组object[]，但Excel处理UDF返回值时，一维数组默认只会渲染第一个元素。要让元素自动填充到相邻行或列，必须返回二维数组：

• 横向填充（多列）：使用object[1, N]结构（1行N列）
• 纵向填充（多行）：使用object[N, 1]结构（N行1列）

修改你的StringSplit函数如下，就能实现横向拆分填充：

[ExcelFunction(Description = "Split string", Category = "STRING")]
public static object[,] StringSplit([ExcelArgument(Name = "TEXT", Description = "text to split")] string text) 
{ 
    var splitWords = text.Split(' ');
    // 创建1行N列的二维数组，对应横向填充
    object[,] result = new object[1, splitWords.Length];
    
    for (int i = 0; i < splitWords.Length; i++)
    {
        result[0, i] = splitWords[i];
    }
    
    return result;
}

注意：Excel 365及以上版本输入公式后直接回车即可自动扩展数组；旧版本需要选中足够多的目标单元格，按Ctrl+Shift+Enter以数组公式形式输入。

二、异步UDF中XlCall.xlfCaller报错的根源与修复 #

你在异步委托里调用Resizer.ResizeMe时触发异常，核心原因是：XlCall.xlfCaller属于Excel的C API调用，必须在Excel主线程的同步上下文执行，而异步委托的代码是在后台线程运行的，此时直接调用Excel API就会抛出未处理异常。

这里提供两种可行的修复方案：

方案1：提前获取调用者信息，传入异步逻辑 #

在进入异步代码块之前，先在主线程获取ExcelReference caller，再把它作为参数传给异步委托，避免在后台线程调用Excel API：

[ExcelFunction(Description = "Async download and extract content", Category = "WEB")]
public static object DownloadAsync([ExcelArgument(Name = "URL")] string url, [ExcelArgument(Name = "XPATH")] string xpath)
{
    // 先在主线程安全获取调用者信息
    ExcelReference caller = XlCall.Excel(XlCall.xlfCaller) as ExcelReference;
    
    return ExcelAsyncUtil.Run("DownloadAsync", new object[] { url, xpath }, delegate { 
        Page page = new Page(); 
        WebResponse resp = page.Download(url); 
        List<string> res = page.GetAllFromXpath(resp.content, xpath); 
        
        object[,] result = new object[1, res.Count]; 
        for (int j = 0; j < res.Count; j++) 
        { 
            result[0, j] = res.ElementAt(j); 
        } 
        // 传入提前获取的caller执行Resize逻辑
        return Resizer.ResizeMe(result, caller); 
    });
}

同时修改Resizer.ResizeMe方法，让它接收外部传入的ExcelReference，而不是在方法内部调用xlfCaller：

public static object ResizeMe(object[,] result, ExcelReference caller)
{
    // 用传入的caller完成你的数组尺寸调整逻辑
    // ... 原有Resize代码，替换掉内部的xlfCaller调用
}

方案2：直接返回固定尺寸的二维数组，跳过Resize #

如果你的异步逻辑能提前确定返回结果的长度，直接创建对应尺寸的二维数组返回即可，完全不需要调用Resizer，这种方式更简洁安全：

[ExcelFunction(Description = "Async download and extract content", Category = "WEB")]
public static object DownloadAsync([ExcelArgument(Name = "URL")] string url, [ExcelArgument(Name = "XPATH")] string xpath)
{
    return ExcelAsyncUtil.Run("DownloadAsync", new object[] { url, xpath }, delegate { 
        Page page = new Page(); 
        WebResponse resp = page.Download(url); 
        List<string> res = page.GetAllFromXpath(resp.content, xpath); 
        
        // 这里选择纵向填充（N行1列），如果要横向就改成new object[1, res.Count]
        object[,] result = new object[res.Count, 1]; 
        for (int j = 0; j < res.Count; j++) 
        { 
            result[j, 0] = res.ElementAt(j); 
        } 
        
        return result; 
    });
}

三、异步UDF的重要注意事项 #

所有涉及Excel C API的操作（比如XlCall系列方法），必须在Excel主线程执行。ExcelAsyncUtil.Run的委托内部只能做纯计算、IO操作这类不直接和Excel交互的逻辑，否则大概率会触发异常。

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