如何在.NET Core中用Open XML SDK为PowerPoint图片添加超链接

我来帮你搞定这个需求！给单张幻灯片里的图片加超链接，在Open XML SDK里需要针对图片形状的动作设置来操作，下面是完整的实现代码和关键说明：

完整代码实现 #

首先确保你已经安装了DocumentFormat.OpenXml NuGet包（直接在NuGet包管理器搜索安装即可），然后用以下代码：

using System;
using System.Linq;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Presentation;
using A = DocumentFormat.OpenXml.Drawing;
using H = DocumentFormat.OpenXml.Drawing.HyperlinkOnClick;
using Office2010 = DocumentFormat.OpenXml.Office2010.Presentation;

namespace PptHyperlinkDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            AddHyperlinkToPptImage("powerpoint.pptx", "https://your-target-url.com");
        }

        static void AddHyperlinkToPptImage(string pptFilePath, string targetUrl)
        {
            // 以可写模式打开PPT文件
            using (var pptDoc = PresentationDocument.Open(pptFilePath, true))
            {
                // 获取演示文稿主部件
                var presentationPart = pptDoc.PresentationPart ?? 
                    throw new InvalidOperationException("无法找到演示文稿核心部件");

                // 获取唯一的幻灯片（你的PPT只有单张）
                var slidePart = presentationPart.SlideParts.FirstOrDefault() ?? 
                    throw new InvalidOperationException("幻灯片不存在");

                var slide = slidePart.Slide;

                // 找到幻灯片中的图片形状（假设只有一张图片）
                var pictureShape = slide.Descendants<Picture>().FirstOrDefault() ?? 
                    throw new InvalidOperationException("幻灯片中未找到图片元素");

                // 获取图片的非视觉绘制属性，这是添加动作设置的入口
                var nonVisualProps = pictureShape.NonVisualPictureProperties.NonVisualDrawingProperties;

                // 1. 给幻灯片添加超链接关系，关联到目标URL
                var hyperlinkRelId = slidePart.AddHyperlinkRelationship(
                    new Uri(targetUrl, UriKind.Absolute), 
                    isExternal: true).Id;

                // 2. 创建超链接动作对象
                var hyperlinkAction = new H.HyperlinkOnClick(
                    new A.Hyperlink { Id = hyperlinkRelId });

                // 3. 准备扩展属性容器（如果不存在则创建）
                var extensionList = nonVisualProps.GetFirstChild<NonVisualDrawingPropertiesExtensionList>() ??
                    new NonVisualDrawingPropertiesExtensionList();
                if (!nonVisualProps.Contains(extensionList))
                {
                    nonVisualProps.Append(extensionList);
                }

                // 4. 创建Office 2010兼容的动作设置扩展
                var actionExtension = new NonVisualDrawingPropertiesExtension
                {
                    Uri = "{FF2B5EF4-FFF2-40B4-BE49-F238E27FC236}" // 固定的动作设置扩展标识
                };

                var actionSetting = new Office2010.ActionSetting
                {
                    Action = Office2010.ActionValues.Hyperlink
                };
                actionSetting.Append(hyperlinkAction);

                actionExtension.Append(new Office2010.CNvPrExt());
                actionExtension.LastChild.Append(actionSetting);

                // 5. 将扩展添加到属性列表
                extensionList.Append(actionExtension);

                // 保存幻灯片更改
                slide.Save();
            }
        }
    }
}

关键逻辑解释 #

• 超链接的绑定方式：PPT里的图片本质是一个Picture形状，超链接不是直接附加在图片上，而是作为形状的点击动作存在，所以我们需要操作图片的非视觉属性来添加这个动作。
• HyperlinkRelationship：必须先给幻灯片部件添加一个外部超链接关系，这个关系会记录目标URL，然后把关系ID绑定到超链接动作上，这样PPT才能识别到跳转地址。
• Office 2010扩展：动作设置的属性是Office 2010及以后版本引入的，所以需要使用Office2010.Presentation命名空间下的类来创建扩展属性。
• 触发方式：保存后的PPT，在编辑模式下需要Ctrl+点击图片跳转；在放映模式下直接点击就能触发超链接。

注意事项 #

• 如果你的PPT有多个图片，需要修改FirstOrDefault()为更精准的查找（比如按图片名称查找，通过NonVisualDrawingProperties.Name属性）。
• 确保目标URL是合法的绝对路径，否则超链接可能无法正常工作。

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