Word VSTO插件替换图片异常：无法找到Shapes与InlineShapes

问题背景 #

开发Word VSTO加载项实现模板处理/导出功能，需点击按钮替换指定图片。编写的ReplaceImage方法通过遍历ActiveDocument的Shapes和InlineShapes，以AlternativeText匹配ImagePath枚举值完成替换，但调试时发现无论图片位于正文、页眉还是页脚，都无法找到任何目标对象。

相关代码定义 #

ImagePath枚举与路径字典 #

public enum ImagePath
{
    TitleLogo,
    Logo
}

public static Dictionary<ImagePath, string> ImagePaths = new Dictionary<ImagePath, string>()
{
    [ImagePath.TitleLogo] = Path.Combine(LocalResourceBasePath, "Images", "***_title_design.png"),
    [ImagePath.Logo] = Path.Combine(LocalResourceBasePath, "Images", "***_logo.png"),
};

原替换核心代码 #

public static void ReplaceImage(ImagePath image)
{
    foreach(Microsoft.Office.Interop.Word.Shape shape in Globals.ThisAddIn.Application.ActiveDocument.Shapes)
    {
        if (shape.AlternativeText == image.ToString())
        {
            object anchor = shape.Anchor;
            Microsoft.Office.Interop.Word.Shape newShape = Globals.ThisAddIn.Application.ActiveDocument.Shapes.AddPicture(
                Constants.ImagePaths[image],
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref anchor);
            newShape.Top = shape.Top;
            newShape.Left = shape.Left;
            newShape.Width = shape.Width;
            newShape.Height = shape.Height;
            shape.Delete();
        }
    }
    foreach(Microsoft.Office.Interop.Word.InlineShape inlineShape in Globals.ThisAddIn.Application.ActiveDocument.InlineShapes)
    {
        if (inlineShape.AlternativeText == image.ToString())
        {
            Microsoft.Office.Interop.Word.InlineShape newInlineShape = Globals.ThisAddIn.Application.ActiveDocument.InlineShapes.AddPicture(
                Constants.ImagePaths[image],
                ref Constants.Missing,
                ref Constants.Missing,
                inlineShape.Range
            );
            newInlineShape.Width = inlineShape.Width;
            newInlineShape.Height = inlineShape.Height;
            inlineShape.Delete();
        }
    }
}

排查与修复方案 #

1. 遗漏页眉页脚的对象遍历 #

Word的页眉、页脚不属于ActiveDocument直接的Shapes/InlineShapes集合，而是隶属于每个Section的HeaderFooter对象。需要遍历文档所有Section的页眉、页脚（含首页、奇数页、偶数页），才能覆盖这些区域的图片。

2. 验证图片的AlternativeText设置 #

确认目标图片的替代文本与枚举值完全一致（注意大小写、空格），避免因匹配条件不成立导致无法找到对象。

3. 重构遍历逻辑的示例代码 #

修改ReplaceImage方法，覆盖文档所有区域的图片：

public static void ReplaceImage(ImagePath image)
{
    var app = Globals.ThisAddIn.Application;
    var doc = app.ActiveDocument;
    var targetAltText = image.ToString();
    var imagePath = Constants.ImagePaths[image];

    // 处理正文区域
    ProcessShapes(doc.Shapes, targetAltText, imagePath);
    ProcessInlineShapes(doc.InlineShapes, targetAltText, imagePath);

    // 处理所有Section的页眉页脚
    foreach (Microsoft.Office.Interop.Word.Section section in doc.Sections)
    {
        // 遍历页眉
        foreach (Microsoft.Office.Interop.Word.HeaderFooter header in section.Headers)
        {
            if (header.Exists)
            {
                ProcessShapes(header.Shapes, targetAltText, imagePath);
                ProcessInlineShapes(header.Range.InlineShapes, targetAltText, imagePath);
            }
        }
        // 遍历页脚
        foreach (Microsoft.Office.Interop.Word.HeaderFooter footer in section.Footers)
        {
            if (footer.Exists)
            {
                ProcessShapes(footer.Shapes, targetAltText, imagePath);
                ProcessInlineShapes(footer.Range.InlineShapes, targetAltText, imagePath);
            }
        }
    }
}

// 提取Shape处理逻辑为辅助方法
private static void ProcessShapes(Microsoft.Office.Interop.Word.Shapes shapes, string targetAltText, string imagePath)
{
    // 倒序遍历避免删除元素导致的索引问题
    for (int i = shapes.Count; i >= 1; i--)
    {
        var shape = shapes[i];
        if (shape.AlternativeText == targetAltText)
        {
            object anchor = shape.Anchor;
            var newShape = shapes.AddPicture(
                imagePath,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref Constants.Missing,
                ref anchor);
            newShape.Top = shape.Top;
            newShape.Left = shape.Left;
            newShape.Width = shape.Width;
            newShape.Height = shape.Height;
            newShape.AlternativeText = targetAltText; // 保留替代文本
            shape.Delete();
        }
    }
}

// 提取InlineShape处理逻辑为辅助方法
private static void ProcessInlineShapes(Microsoft.Office.Interop.Word.InlineShapes inlineShapes, string targetAltText, string imagePath)
{
    // 倒序遍历避免删除元素导致的索引问题
    for (int i = inlineShapes.Count; i >= 1; i--)
    {
        var inlineShape = inlineShapes[i];
        if (inlineShape.AlternativeText == targetAltText)
        {
            var newInlineShape = inlineShapes.AddPicture(
                imagePath,
                ref Constants.Missing,
                ref Constants.Missing,
                inlineShape.Range);
            newInlineShape.Width = inlineShape.Width;
            newInlineShape.Height = inlineShape.Height;
            newInlineShape.AlternativeText = targetAltText; // 保留替代文本
            inlineShape.Delete();
        }
    }
}

额外说明 #

• 使用倒序遍历集合：避免在删除元素时打乱正序遍历的索引，导致遗漏或异常。
• 新图片保留替代文本：确保后续替换操作能正常匹配目标对象。

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