在 Word 文檔中，圖片和形狀可以添加超鏈接，用于跳轉到外部網站、文件，或文檔中的特定位置。然而，隨著外部資源的變動或文檔結構的調整，超鏈接指向的目標地址或文件路徑可能會發生變化。這種情況下，如果不及時更新超鏈接，可能會導致鏈接失效，進而影響文檔的正常使用和用戶體驗。這篇文章將介紹如何使用 Spire.Doc for .NET 在 C# 中以編程方式修改 Word 文檔中圖片和形狀的超鏈接。

安裝 Spire.Doc for .NET

首先，您需要將 Spire.Doc for.NET 包含的 DLL 文件作為引用添加到您的 .NET 項目中。您也可以通過  安裝。

PM> Install-Package Spire.Doc

C# 修改 Word 中圖片的超鏈接

Spire.Doc for .NET 提供了 DocPicture.HasHyperlink 屬性，用于檢測圖片是否包含超鏈接。一旦檢測到超鏈接，可以通過 DocPicture.HRef 屬性來更新或修改超鏈接。詳細步驟如下：

• 創建 Document 類的實例。
• 使用 Document.LoadFromFile() 方法加載 Word 文檔。
• 遍歷文檔中的所有節、段落和段落中的子對象。
• 檢查對象是否為 DocPicture 類型（即圖片）。
• 使用 DocPicture.HasHyperlink 屬性檢查圖片是否包含超鏈接。
• 使用 DocPicture.HRef 屬性修改超鏈接內容（若需刪除超鏈接，將其值設為空）。
• 使用 Document.SaveToFile() 方法保存修改后的文檔。

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;

namespace UpdateHyperlinkForImage
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 創建 Document 類的實例
            Document doc = new Document();
            // 加載 Word 文檔
            doc.LoadFromFile("示例1.docx");

            // 遍歷文檔中的所有節
            foreach (Section section in doc.Sections)
            {
                // 遍歷節中的所有段落
                foreach (Paragraph paragraph in section.Paragraphs)
                {
                    // 遍歷段落中的所有子對象
                    foreach (DocumentObject documentObject in paragraph.ChildObjects)
                    {
                        // 檢查子對象是否為 DocPicture 類型
                        if (documentObject is DocPicture)
                        {
                            DocPicture pic = documentObject as DocPicture;

                            // 檢查該圖片是否包含超鏈接
                            if (pic.HasHyperlink)
                            {
                                // 更新圖片超鏈接（若需刪除超鏈接，將值設置為空）
                                pic.;
                            }
                        }
                    }
                }
            }

            // 保存修改后的文檔到指定路徑
            doc.SaveToFile("修改圖片超鏈接.docx", FileFormat.Docx2016);
            // 關閉文檔，釋放資源
            doc.Close();
        }
    }
}

C# 修改 Word 中形狀的超鏈接

與修改圖片超鏈接類似，你可以使用 ShapeObject.HasHyperlink 屬性檢測形狀是否包含超鏈接，并通過 ShapeObject.HRef 屬性更新或修改超鏈接。詳細步驟如下：

• 創建 Document 類的實例。
• 使用 Document.LoadFromFile() 方法加載 Word 文檔。
• 遍歷文檔中的所有節、段落和段落中的子對象。
• 檢查對象是否為 ShapeObject 類型（即形狀）。
• 使用 ShapeObject.HasHyperlink 屬性檢查形狀是否包含超鏈接。
• 使用 ShapeObject.HRef 屬性修改超鏈接內容（若需刪除超鏈接，將其值設為空）。
• 使用 Document.SaveToFile() 方法保存修改后的文檔。

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;

namespace UpdateHyperlinkForShape
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 創建 Document 類的實例
            Document doc = new Document();
            // 加載 Word 文檔
            doc.LoadFromFile("示例2.docx");

            // 遍歷文檔中的所有節
            foreach (Section section in doc.Sections)
            {
                // 遍歷節中的所有段落
                foreach (Paragraph paragraph in section.Paragraphs)
                {
                    // 遍歷段落中的所有子對象
                    foreach (DocumentObject documentObject in paragraph.ChildObjects)
                    {
                        // 檢查子對象是否為 ShapeObject 類型
                        if (documentObject is ShapeObject)
                        {
                            ShapeObject shape = documentObject as ShapeObject;

                            // 檢查該形狀是否包含超鏈接
                            if (shape.HasHyperlink)
                            {
                                // 更新形狀超鏈接（若需刪除超鏈接，將值設置為空）
                                shape.;
                            }
                        }
                    }
                }
            }

            // 保存修改后的文檔到指定路徑
            doc.SaveToFile("修改形狀超鏈接.docx", FileFormat.Docx2016);
            // 關閉文檔，釋放資源
            doc.Close();
        }
    }
}

歡迎下載|體驗更多E-iceblue產品