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'"。

下面的程式碼範例示範如何取代新渲染的 PDF 文件中包含文字".NET6"的文字。 當需要將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

處理多頁文件時，應考慮實施PDF 壓縮，以在文字替換作業後最佳化文件大小，尤其是在處理大型文件或批次處理場景時。

如何在替換文字時使用自訂字體？

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還為複雜場景提供了強大的功能。 使用範本或動態文件時，可以將文字替換與其他功能結合使用，例如添加文字和圖像印章或添加數位簽章。 對於需要批次處理的應用，應同時實現文字替換、非同步和多執行緒功能，以優化同時處理多個 PDF 時的效能。 這在文件吞吐量至關重要的企業環境中尤其有用。 在替換敏感資訊時，請探索 IronPDF 的編輯功能，以永久刪除機密數據，確保符合資料保護法規。

常見問題解答

如何使用 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 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 17,803,474 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎？

想快速取得證據？ PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。