搜索文本并添加超链接

本教程介绍如何使用 Aspose.PDF for .NET 搜索 PDF 文档中的特定文本、添加找到的文本的超链接以及保存修改后的文档。提供的 C# 源代码逐步演示了该过程。

先决条件

在继续学习本教程之前，请确保您具备以下条件：

C# 编程语言的基础知识。
安装了 Aspose.PDF for .NET 库。您可以从 Aspose 网站获取它或使用 NuGet 将其安装到您的项目中。

第 1 步：设置项目

首先在您首选的集成开发环境 (IDE) 中创建一个新的 C# 项目，并添加对 Aspose.PDF for .NET 库的引用。

第2步：导入必要的命名空间

在 C# 文件的开头添加以下 using 指令以导入所需的命名空间：

using Aspose.Pdf;
using Aspose.Pdf.Content;
using Aspose.Pdf.Facades;
using Aspose.Pdf.Text;

第三步：设置文档目录路径

使用以下命令设置文档目录的路径dataDir多变的：

string dataDir = "YOUR DOCUMENT DIRECTORY";

代替"YOUR DOCUMENT DIRECTORY"与文档目录的实际路径。

第四步：创建一个TextFragmentAbsorber

创建一个TextFragmentAbsorber对象查找输入搜索短语的所有实例：

TextFragmentAbsorber absorber = new TextFragmentAbsorber("\\d{4}-\\d{4}");

代替"\\d{4}-\\d{4}"与您想要的正则表达式模式。

第 5 步：启用正则表达式搜索

通过设置启用正则表达式搜索TextSearchOptions吸收体的特性：

absorber.TextSearchOptions = new TextSearchOptions(true);

步骤6：打开并绑定PDF文档

创建一个PdfContentEditor对象并将其绑定到源 PDF 文件：

PdfContentEditor editor = new PdfContentEditor();
editor.BindPdf(dataDir + "SearchRegularExpressionPage.pdf");

代替"SearchRegularExpressionPage.pdf"与您的 PDF 文件的实际名称。

第 7 步：接受页面的吸收器

接受文档所需页面的吸收器：

editor.Document.Pages[1].Accept(absorber);

代替1与所需的页码。

步骤 8：将超链接添加到找到的文本

循环检索到的文本片段并向其添加超链接：

foreach (TextFragment textFragment in absorber.TextFragments)
{
    textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Blue;
    //根据文本片段的位置创建一个矩形
    System.Drawing.Rectangle rect = new System.Drawing.Rectangle((int)textFragment.Rectangle.LLX,
        (int)Math.Round(textFragment.Rectangle.LLY), (int)Math.Round(textFragment.Rectangle.Width + 2),
        (int)Math.Round(textFragment.Rectangle.Height + 1));
    //将网络链接添加到矩形
    editor.CreateWebLink(rect, "http://www.aspose.com", 1, System.Drawing.Color.Blue);
}

代替"http://www.aspose.com"与所需的超链接 URL。

步骤9：保存并关闭修改后的文档

保存修改后的文档并关闭编辑器：

dataDir = dataDir + "SearchTextAndAddHyperlink_out.pdf";
editor.Save(dataDir);
editor.Close();
Console.WriteLine("\nText replaced and hyperlink added successfully based on a regular expression.\nFile saved at " + dataDir);

确保更换"SearchTextAndAddHyperlink_out.pdf"与所需的输出文件名。

使用 Aspose.PDF for .NET 搜索文本和添加超链接的示例源代码

//文档目录的路径。
string dataDir = "YOUR DOCUMENT DIRECTORY";
//创建吸收器对象以查找输入搜索短语的所有实例
TextFragmentAbsorber absorber = new TextFragmentAbsorber("\\d{4}-\\d{4}");
//启用正则表达式搜索
absorber.TextSearchOptions = new TextSearchOptions(true);
//打开文档
PdfContentEditor editor = new PdfContentEditor();
//绑定源PDF文件
editor.BindPdf(dataDir + "SearchRegularExpressionPage.pdf");
//接受页面的吸收器
editor.Document.Pages[1].Accept(absorber);
int[] dashArray = { };
String[] LEArray = { };
System.Drawing.Color blue = System.Drawing.Color.Blue;
//循环遍历片段
foreach (TextFragment textFragment in absorber.TextFragments)
{
	textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Blue;
	System.Drawing.Rectangle rect = new System.Drawing.Rectangle((int)textFragment.Rectangle.LLX,
		(int)Math.Round(textFragment.Rectangle.LLY), (int)Math.Round(textFragment.Rectangle.Width + 2),
		(int)Math.Round(textFragment.Rectangle.Height + 1));
	Enum[] actionName = new Enum[2] { Aspose.Pdf.Annotations.PredefinedAction.Document_AttachFile, Aspose.Pdf.Annotations.PredefinedAction.Document_ExtractPages };
	editor.CreateWebLink(rect, "http://www.aspose.com", 1, 蓝色, actionName);
	editor.CreateLine(rect, "", (float)textFragment.Rectangle.LLX + 1, (float)textFragment.Rectangle.LLY - 1,
		(float)textFragment.Rectangle.URX, (float)textFragment.Rectangle.LLY - 1, 1, 1, blue, "S", dashArray, LEArray);
}
dataDir = dataDir + "SearchTextAndAddHyperlink_out.pdf";
editor.Save(dataDir);
editor.Close();
Console.WriteLine("\nText replaced and hyperlink added successfully based on a regular expression.\nFile saved at " + dataDir);

结论

恭喜！您已经成功学习了如何在 PDF 文档中搜索特定文本、向找到的文本添加超链接以及使用 Aspose.PDF for .NET 保存修改后的文档。本教程提供了从设置项目到执行所需操作的分步指南。现在，您可以将此代码合并到您自己的 C# 项目中，以操作文本并在 PDF 文件中添加超链接。

常见问题解答

问：“搜索文本并添加超链接”教程的目的是什么？

答：“搜索文本并添加超链接”教程旨在演示如何使用 Aspose.PDF .NET 库在 PDF 文档中搜索特定文本，向找到的文本添加超链接，然后保存修改后的文档。本教程提供了全面的指南和 C# 代码示例来说明分步过程。

问：本教程如何帮助您在 PDF 文档中添加指向特定文本的超链接？

答：本教程将指导您完成使用 Aspose.PDF 库来查找 PDF 文档中的特定文本、将超链接应用到所识别的文本以及保存修改后的 PDF 的过程。它涵盖了一些基本步骤，例如设置项目、加载文档、启用正则表达式搜索以及向找到的文本添加超链接。

问：学习本教程需要什么先决条件？

答：开始之前，您应该对 C# 编程语言有基本的了解。此外，您还需要安装 Aspose.PDF for .NET 库，该库可以从 Aspose 网站获取或在项目中使用 NuGet 安装。

问：如何设置我的项目来遵循本教程？

答：首先在您首选的集成开发环境 (IDE) 中创建一个新的 C# 项目。然后，添加对 Aspose.PDF for .NET 库的引用，这将使您能够在项目中利用该库的功能。

问：我可以使用本教程添加指向特定文本的超链接吗？

答：是的，本教程特别关注在 PDF 文档中添加指向特定文本的超链接。它演示了如何使用正则表达式查找和提取所需的文本、创建与文本片段关联的超链接以及保存修改后的 PDF。

问：如何定义要搜索的文本并添加超链接？

答：要指定要搜索的文本并添加超链接，请创建一个TextFragmentAbsorber对象并使用设置其模式Text范围。替换默认模式"\\d{4}-\\d{4}"在教程的代码中添加您所需的正则表达式模式。

问：如何启用文本的正则表达式搜索？

A：通过创建一个来启用正则表达式搜索TextSearchOptions对象并将其值设置为true。将此对象分配给TextSearchOptions的财产TextFragmentAbsorber实例。这可确保在文本搜索期间应用正则表达式模式。

问：如何向找到的文本添加超链接？

A：使用识别文本片段后TextFragmentAbsorber，本教程提供了一个循环来迭代这些片段。对于每个文本片段，本教程演示了如何将文本颜色设置为蓝色并使用CreateWebLink方法。

问：保存修改后的带有超链接的PDF的步骤是什么？

A：将超链接添加到所需的文本片段后，使用PdfContentEditor类来保存修改后的文档。本教程的示例代码展示了如何保存编辑后的 PDF、关闭编辑器以及显示成功消息。

在 PDF 文件中搜索正则表达式搜索文本并绘制矩形