1. IronPDF
  2. 操作指南
  3. 在PDF中替换文本
如何在PDF中替换文本 | IronPDF

如何使用 C# 替换 PDF 中的文本

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

使用 IronPDF 的简单 API，通过 C# 替换 PDF 中的文本 - 使用 ReplaceTextOnAllPages() 进行文档范围的更改，或使用 ReplaceTextOnPage() 进行特定页面的更改。 这可以在 .NET 应用程序中实现自动更正、模板定制和动态内容更新。

快速入门：使用IronPDF替换 PDF 中的文本

使用 IronPDF 轻松开始替换 PDF 中的文本。 只需几行代码，您就可以快速更新或定制文档。 此示例演示如何替换 PDF 所有页面上的文本。 只需加载您的 PDF，指定要查找和替换的文本，并保存更新后的文档。 IronPDF 是纠正错别字或更新模板中信息的完美工具，它使 C# 中的文本替换变得天衣无缝。 深入了解本指南，在 .NET 环境中提升您的 PDF 处理效率。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

    IronPdf.PdfDocument.FromFile("example.pdf")
    .ReplaceTextOnAllPages("old text", "new text")
    .SaveAs("updated.pdf");

  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronPDF

    arrow pointer

最小工作流程(5 个步骤)

  1. 下载 IronPDF C# 库。
  2. 生成一个新的PDF或导入现有的PDF文档
  3. 使用 `ReplaceTextOnAllPages` 方法替换整个文档中的文本
  4. 指定要替换文本的目标页码
  5. 导出编辑后的 PDF 文档


如何替换 PDF 中的文本？

"替换文本"操作可以应用于任何 PdfDocument 对象，无论是新渲染的还是导入的。 使用 ReplaceTextOnAllPages 方法，同时提供要替换的旧文本和新文本。 如果该方法无法找到指定的旧文本，则会引发异常，提示 "替换文本时出错：未能找到文本 '.NET6'" 。

在下面的代码示例中，我们演示如何在包含文本'.NET6'的新的 PDF 文档上替换文本。 在处理 HTML 到 PDF 的转换或需要编辑现有 PDF 时，该功能尤其有用。

基本代码是什么样的？

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-all-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
$vbLabelText   $csharpLabel

在应用程序中实施文本替换时，您可能还想探索在 PDF 中添加页眉和页脚或应用自定义水印，以增强文档品牌和标识。

如何替换带有换行符的文本？

替换文本操作支持换行符，允许您用包括内置换行符的新字符串替换旧文本，以实现更好的格式和视觉清晰度。 当您需要保持适当的文档结构或处理 多行文本内容时，这一功能至关重要。 要实现这一点，请在新字符串中添加换行符(\n)。 以上述示例为例，将 newText 替换为 .NET7\nnewline，而不是仅替换为 .NET7。 这种方法可与 IronPDF 中的各种 渲染选项无缝配合。

如何替换指定页面上的文本？

为了更准确地替换文档中的文本，IronPDF 提供了替换单页或多页文本的选项。 使用 ReplaceTextOnPage 方法替换特定页面上的文本，使用 ReplaceTextOnPages 方法替换多个指定页面上的文本。 在处理 复杂的 PDF 表单或页面内容各不相同的文档时，这种细粒度控制尤其有用。

提示所有页面索引均采用从零开始的索引方式。

如何替换单个页面上的文本？

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-on-single-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on page 1
pdf.ReplaceTextOnPage(0, oldText, newText);

pdf.SaveAs("replaceTextOnSinglePage.pdf");
$vbLabelText   $csharpLabel

这种单页替换功能与其他特定页面的操作(如 添加页码或需要 拆分 PDF 以进行有针对性的内容修改时)集成得很好。

如何替换多个页面上的文本？

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-on-multiple-pages.cs
using IronPdf;

string html = @"<p> .NET6 </p>
<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> .NET6 </p>
<p> This is 3rd Page</p>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

string oldText = ".NET6";
string newText = ".NET7";

int[] pages = { 0, 2 };

// Replace text on page 1 & 3
pdf.ReplaceTextOnPages(pages, oldText, newText);

pdf.SaveAs("replaceTextOnMultiplePages.pdf");
$vbLabelText   $csharpLabel

在处理多页文档时，请考虑实施 DF 压缩，以优化文本替换操作后的文件大小，尤其是在处理大型文档或批量处理场景时。

在替换文本时如何使用自定义字体？

ReplaceTextOnPage 方法还允许您使用自定义字体和字号。首先，将字体添加到 PDF 中，然后将字体名称作为参数传递给该方法。 在下面的示例中，我使用了 Pixelify Sans 字体。 在保持品牌一致性或使用 国际语言和 UTF-8 支持时，自定义字体的实现尤为重要。

自定义字体实施需要哪些步骤？

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-custom-font.cs
using IronPdf;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Use custom font .NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Add custom font
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var pdfFont = pdf.Fonts.Add(fontByte);

// Use custom font
pdf.ReplaceTextOnPage(0, oldText, newText, pdfFont, 24);

pdf.SaveAs("replaceCustomText.pdf");
$vbLabelText   $csharpLabel
对比显示从 .NET 6 迁移到 .NET 7 时自定义字体的使用情况，箭头向下

高级文本替换场景

除了基本的文本替换功能外，IronPDF 还为复杂场景提供了强大的功能。 在使用模板或动态文档时，应将文本替换与其他功能结合起来，如给文本和图像盖章或添加数字签名。 对于需要批量处理的应用程序，在实现文本替换的同时，还需具备 async 和多线程功能，以便在同时处理多个 PDF 时优化性能。 这在文档吞吐量至关重要的企业环境中尤其有用。 在替换敏感信息时，请探索 IronPDF 的 redaction 功能，以永久删除机密数据，确保符合数据保护法规。

常见问题解答

如何使用 C# 在 PDF 的所有页面中替换文本？

使用 IronPDF，您可以使用 ReplaceTextOnAllPages() 方法轻松替换所有页面的文本。只需加载您的 PDF 文档，调用该方法的旧文本和新文本参数，然后保存更新后的文档即可。该功能非常适合批量更正和模板更新。

我能否只替换特定页面上的文本，而不是整个文档？

是的，IronPDF 提供了 ReplaceTextOnPage() 方法，允许您针对特定页面进行文本替换。这样，您就可以精确控制哪些页面会被修改，非常适合在多页文档中进行选择性更新。

如果 PDF 中没有我要替换的文本，该怎么办？

当 IronPDF 无法找到要替换的指定文本时，它会引发异常，并给出明确的错误信息，说明未找到文本。这有助于您处理文档中可能不存在搜索文本的情况。

是否可以替换包含换行符的文本？

是的，IronPDF 的替换文本功能完全支持换行符。您可以用包含内置换行符的新字符串替换旧文本，从而为多行内容保持正确的文档格式和结构。

能否在 HTML 创建的 PDF 上使用文本替换？

当然可以！IronPDF 的文本替换功能可在 HTML 转换生成的 PDF 上无缝运行。无论您是从 HTML 创建 PDF 还是导入现有文档，ReplaceTextOnAllPages() 方法的功能都是相同的。

在 PDF 中实现文本替换的主要步骤是什么？

使用 IronPDF 的过程包括五个简单步骤：首先，下载并安装库。第二，渲染或导入 PDF 文档。第三，使用 ReplaceTextOnAllPages() 进行文档范围内的更改。第四，可选择指定页码进行有针对性的替换。最后，使用 SaveAs() 保存编辑后的 PDF。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 17,803,474 | 版本: 2026.3 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。