在 Word 文檔中，圖片和形狀可以添加超鏈接，用于跳轉(zhuǎn)到外部網(wǎng)站、文件，或文檔中的特定位置。然而，隨著外部資源的變動(dòng)或文檔結(jié)構(gòu)的調(diào)整，超鏈接指向的目標(biāo)地址或文件路徑可能會(huì)發(fā)生變化。這種情況下，如果不及時(shí)更新超鏈接，可能會(huì)導(dǎo)致鏈接失效，進(jìn)而影響文檔的正常使用和用戶(hù)體驗(yàn)。這篇文章將介紹如何使用 Spire.Doc for .NET 在 C# 中以編程方式修改 Word 文檔中圖片和形狀的超鏈接。

安裝 Spire.Doc for .NET

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

PM> Install-Package Spire.Doc

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

歡迎下載|體驗(yàn)更多E-iceblue產(chǎn)品