如何在Asp.Net中用DocumentFormat.OpenXML为导出Word插入图片

阿华AIGC实验室

2026-5-6

解决OpenXML AltChunk导入HTML时图片不显示的问题

你遇到的核心问题是：通过AltChunk插入HTML到Word文档时，HTML中的图片引用的是Web路径或相对路径，而生成的Word文档是本地文件，无法直接访问这些外部资源，导致图片无法显示。要解决这个问题，我们需要把图片嵌入到Word文档内部，同时调整HTML中的图片引用指向文档内的嵌入式资源。

下面是修改后的完整解决方案，我会一步步说明关键改动：

步骤说明

解析HTML中的图片标签：使用HtmlAgilityPack（需通过NuGet安装）遍历HTML里的<img>标签，提取图片URL。
下载图片并嵌入到Word文档：将每张图片下载到内存流，添加到Word的ImagePart中，获取对应的关系ID。
修改HTML的图片引用：把原HTML中的src替换为Word内部资源的引用格式（cid:{关系ID}）。
插入修改后的HTML到Word：用处理后的HTML生成AltChunk，插入到文档中。

修改后的代码

首先，确保你已安装HtmlAgilityPack和DocumentFormat.OpenXml NuGet包。

1. 更新`exporttoword`方法

private void exporttoword(string FilePath, string ReportText)
{
    // 先处理HTML中的图片，将其嵌入到Word文档
    string processedHtml = ProcessHtmlImages(FilePath, ReportText);

    using (WordprocessingDocument myDoc = WordprocessingDocument.Open(FilePath, true))
    {
        string altChunkId = "AltChunkId1";
        MainDocumentPart mainPart = myDoc.MainDocumentPart;
        AlternativeFormatImportPart chunk = mainPart.AddAlternativeFormatImportPart(AlternativeFormatImportPartType.Html, altChunkId);

        using (Stream chunkStream = chunk.GetStream(FileMode.Create, FileAccess.Write))
        {
            using (StreamWriter streamWriter = new StreamWriter(chunkStream))
            {
                streamWriter.Write(processedHtml);
            }
        }

        AltChunk altChunk = new AltChunk();
        altChunk.Id = altChunkId;

        // 将处理后的HTML块插入到文档末尾
        mainPart.Document.Body.InsertAfter(altChunk, mainPart.Document.Body.Elements<Paragraph>().Last());
        mainPart.Document.Save();
    }

    // 下载逻辑保持不变
    System.IO.FileInfo file = new System.IO.FileInfo(FilePath);
    if (file.Exists)
    {
        Response.Clear();
        Response.AddHeader("Content-Disposition", "attachment; filename=" + file.Name);
        Response.AddHeader("Content-Length", file.Length.ToString());
        Response.ContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
        Response.WriteFile(file.FullName);
        Response.End();
    }
    else
    {
        rdWMngr.RadAlert("Error", 400, 150, "Saved Report", null, clsConstants.WarningMessage);
    }
}

2. 添加`ProcessHtmlImages`方法（处理图片嵌入）

private string ProcessHtmlImages(string wordFilePath, string htmlContent)
{
    HtmlDocument htmlDoc = new HtmlDocument();
    htmlDoc.LoadHtml(htmlContent);

    using (WordprocessingDocument myDoc = WordprocessingDocument.Open(wordFilePath, true))
    {
        MainDocumentPart mainPart = myDoc.MainDocumentPart;

        // 遍历HTML中所有的img标签
        foreach (HtmlNode imgNode in htmlDoc.DocumentNode.SelectNodes("//img") ?? Enumerable.Empty<HtmlNode>())
        {
            string imgSrc = imgNode.GetAttributeValue("src", string.Empty);
            if (string.IsNullOrEmpty(imgSrc)) continue;

            try
            {
                // 处理图片路径：如果是相对路径，转换为网站绝对路径
                Uri imgUri;
                if (!Uri.TryCreate(imgSrc, UriKind.Absolute, out imgUri))
                {
                    string domain = HttpContext.Current.Request.Url.Authority;
                    imgUri = new Uri($"http://{domain}{imgSrc}");
                }

                // 下载图片到内存流
                using (WebClient client = new WebClient())
                {
                    using (Stream imgStream = client.OpenRead(imgUri))
                    {
                        // 创建ImagePart并设置对应的图片类型
                        ImagePart imagePart = mainPart.AddImagePart(GetImageContentType(imgUri.AbsolutePath));
                        imagePart.FeedData(imgStream);

                        // 获取ImagePart在文档中的关系ID
                        string rId = mainPart.GetIdOfPart(imagePart);

                        // 修改img标签的src为Word识别的内部资源格式
                        imgNode.SetAttributeValue("src", $"cid:{rId}");
                    }
                }
            }
            catch (Exception ex)
            {
                // 处理图片下载失败的情况，可根据需求调整（比如保留原路径或替换占位图）
                imgNode.SetAttributeValue("src", "");
                imgNode.SetAttributeValue("alt", "图片加载失败");
            }
        }
    }

    return htmlDoc.DocumentNode.OuterHtml;
}

// 辅助方法：根据图片扩展名获取对应的Content-Type
private string GetImageContentType(string imagePath)
{
    string extension = Path.GetExtension(imagePath).ToLowerInvariant();
    return extension switch
    {
        ".jpg" or ".jpeg" => "image/jpeg",
        ".png" => "image/png",
        ".gif" => "image/gif",
        ".bmp" => "image/bmp",
        _ => "image/png" // 默认使用PNG类型
    };
}

关键知识点解释

cid:{rId}格式：这是Word文档引用内部嵌入式资源的标准格式，rId是图片对应的ImagePart在文档中的唯一关系ID，Word会通过这个ID找到打包在docx内部的图片资源。
ImagePart的作用：每个嵌入的图片都会被添加到Word文档的MainDocumentPart下，相当于把图片直接打包到docx文件中，彻底消除外部依赖。
HtmlAgilityPack的优势：相比原生字符串替换，它能可靠解析和修改复杂HTML结构，避免因HTML格式不规则导致的处理失败。