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

Updated: 2026年4月22日

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

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

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2复制并运行这段代码。

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

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

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

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

最小工作流程（5 个步骤）

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

如何替换 PDF 中的文本？

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

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

基本代码是什么样的？

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");

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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

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

pdf.SaveAs("replaceText.pdf")

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

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

pdf.SaveAs("replaceText.pdf")

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

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

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

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

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

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

如何在单页上替换文本？

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");

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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

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

pdf.SaveAs("replaceTextOnSinglePage.pdf")

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

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

pdf.SaveAs("replaceTextOnSinglePage.pdf")

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

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

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");

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");

Imports IronPdf

Private html As String = "<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>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

Private pages() As Integer = { 0, 2 }

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

pdf.SaveAs("replaceTextOnMultiplePages.pdf")

Imports IronPdf

Private html As String = "<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>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

Private pages() As Integer = { 0, 2 }

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

pdf.SaveAs("replaceTextOnMultiplePages.pdf")

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

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

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

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

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

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");

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");

Imports IronPdf
Imports System.IO

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Use custom font .NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Add custom font
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private pdfFont = pdf.Fonts.Add(fontByte)

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

pdf.SaveAs("replaceCustomText.pdf")

Imports IronPdf
Imports System.IO

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Use custom font .NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Add custom font
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private pdfFont = pdf.Fonts.Add(fontByte)

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

pdf.SaveAs("replaceCustomText.pdf")

对比显示从 .NET 6 迁移到 .NET 7 时自定义字体的使用情况，箭头向下

高级文本替换场景

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

常见问题解答

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

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

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

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

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

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

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

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

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

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

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

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

What are some advanced use cases for text replacement in PDFs using IronPDF?

Advanced use cases for text replacement with IronPDF include combining it with stamping features, adding signatures, implementing async processing for batch operations, and utilizing redaction for sensitive information.

How do I handle exceptions when replacing text using IronPDF?

When using `ReplaceTextOnAllPages()`, if the old text cannot be found, IronPDF raises an exception with a detailed message. Handling these exceptions ensures reliable text replacement operations.

Is it possible to integrate text replacement with other PDF operations?

Yes, IronPDF allows integration of text replacement with other PDF operations like adding headers, footers, stamping, and more, providing comprehensive document management capabilities.

How does IronPDF ensure performance during large document processing?

IronPDF supports async and multithreading capabilities, optimizing performance and enabling high throughput in enterprise environments when processing large or multiple PDF documents.