使用C#在Word文档中添加文本和图片超链接的实现方式方式实用指南

Install-Package Spire.Doc

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using Spire.Doc.Interface;
using System.Drawing; // 用于处理颜色和图像

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using Spire.Doc.Interface;
using System.Drawing;
using System.IO;

namespace AddHyperlinksToExistingText
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 初始化文档并加载本地文件
            Document document = new Document();
            // 请根据实际情况修改文件路径
            string inputPath = @"C:UsersAdministratorDesktopsample.docx";
            
            if (!File.Exists(inputPath))
            {
                System.Console.WriteLine("未找到源文件，请检查路径。");
                return;
            }

            document.LoadFromFile(inputPath);

            // 2. 查找目标字符串 ".NET Framework"
            // 参数：搜索词，区分大小写，全字匹配
            TextSelection[] selections = document.FindAllString(".NET Framework", true, true);

            // 确保至少找到了两次，我们要操作的是第二次
            if (selections.Length > 1)
            {
                // 获取第二次出现的文本范围
                TextRange range = selections[1].GetAsOneRange();
                
                // 获取该文本所在的段落
                Paragraph paragraph = range.OwnerParagraph;

                // 获取该文本在段落元素集合中的索引位置
                int index = paragraph.Items.IndexOf(range);

                // 3. 移除原始纯文本，准备替换为超链接域
                paragraph.Items.Remove(range);

                // 4. 创建超链接域对象
                Field field = new Field(document);
                field.Type = FieldType.FieldHyperlink;
                
                // 配置超链接的具体地址
                Hyperlink hyperlink = new Hyperlink(field);
                hyperlink.Type = HyperlinkType.WebLink;
                hyperlink.Uri = "https://en.wikipedia.org/wiki/.NET_Framework";

                // 将域的起始部分插入到原位置
                paragraph.Items.Insert(index, field);

                // 5. 插入域分隔符 (FieldSeparator)
                // 这是告诉 Word："前面是命令，后面是显示内容"
                IParagraphBase startMark = document.CreateParagraphItem(ParagraphItemType.FieldMark);
                (startMark as FieldMark).Type = FieldMarkType.FieldSeparator;
                paragraph.Items.Insert(index + 1, startMark);

                // 6. 插入显示的文本内容
                ITextRange textRange = new TextRange(document);
                textRange.Text = ".NET Framework";
                
                // 关键：保留原文本的字体设置，并应用超链接样式（蓝色 + 下划线）
                textRange.CharacterFormat.Font = range.CharacterFormat.Font;
                textRange.CharacterFormat.TextColor = Color.Blue;
                textRange.CharacterFormat.UnderlineStyle = UnderlineStyle.Single;
                
                paragraph.Items.Insert(index + 2, textRange);

                // 7. 插入域结束标记 (FieldEnd)
                IParagraphBase endMark = document.CreateParagraphItem(ParagraphItemType.FieldMark);
                (endMark as FieldMark).Type = FieldMarkType.FieldEnd;
                paragraph.Items.Insert(index + 3, endMark);

                // 8. 保存结果
                string outputPath = "Result_TextLink.docx";
                document.SaveToFile(outputPath, FileFormat.Docx);
                
                System.Console.WriteLine($"处理完成！文件已保存至：{outputPath}");
            }
            else
            {
                System.Console.WriteLine("文档中未找到足够的匹配项。");
            }
        }
    }
}

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing;
using System.IO;

namespace CreateImageLink
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 创建新文档
            Document doc = new Document();
            Section section = doc.AddSection();
            Paragraph paragraph = section.AddParagraph();

            // 设置段落对齐方式（可选，让图片居中更好看）
            paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center;

            string imagePath = "logo.png"; // 请确保项目目录下有此图片

            if (File.Exists(imagePath))
            {
                // 2. 加载图片并转换为 DocPicture 对象
                Image image = Image.FromFile(imagePath);
                DocPicture picture = new DocPicture(doc);
                picture.LoadImage(image);

                // 3. 一行代码搞定：添加图片超链接
                // 参数说明：目标网址，图片对象，链接类型
                paragraph.AppendHyperlink("https://www.e-iceblue.com", picture, HyperlinkType.WebLink);

                // 4. 保存文档
                string outputPath = "Result_ImageLink.docx";
                doc.SaveToFile(outputPath, FileFormat.Docx);

                System.Console.WriteLine($"图片链接添加成功！文件已保存至：{outputPath}");
            }
            else
            {
                System.Console.WriteLine($"未找到图片文件：{imagePath}");
            }
        }
    }
}