如何使用IXLWorksheet通过URL向Excel文件添加图片

开发者阿泽

2026-10-3

问题原因

ClosedXML 提供的 IXLWorksheet.AddPicture 方法原生不支持直接传入 HTTP/HTTPS 网络 URL 作为参数，仅支持本地文件路径、Stream 流对象或 Image 对象作为入参，所以直接传入网络地址会抛出路径格式不支持的异常。

解决方案

你可以先将网络图片下载到内存流中，再将流对象传入 AddPicture 方法实现需求，修改后的参考代码如下：

首先在类级别声明静态的 HttpClient 实例，避免重复实例化导致端口耗尽：

private static readonly HttpClient _httpClient = new HttpClient();

调整业务方法逻辑：

private void createReport(ref IXLWorksheet w)
{
    ...
    w.Range($"S{rowCounter}:U{rowCounter}").Merge();
    var targetCell = w.Cell($"S{rowCounter}");
    var logoUrl = "https://sm.mashable.com/t/mashable_in/photo/default/nasa-galaxy_9pu4.1248.jpg";
    
    // 下载图片到内存流后添加到工作表
    using (var imageStream = _httpClient.GetStreamAsync(logoUrl).GetAwaiter().GetResult())
    {
        // 可根据需求调整图片位置、缩放比例或固定尺寸
        w.AddPicture(imageStream)
         .MoveTo(targetCell)
         .Scale(0.6);
    }
    ...
}

如果你的方法支持异步写法，可以把 GetAwaiter().GetResult() 替换为 await 关键字，同时给方法添加 async 修饰符即可。