如何在PDF中替換文字

replaceText接受哪些參數？

方法簽名是replaceText(PageSelection pageSelection, String oldText, String newText)。 預設情況下匹配是區分大小寫的："NET6"被視為不同的字串。 在調用該方法之前，請驗證已渲染PDF中的精確大小寫。 您可以先提取PDF的文字內容來確認精確的文字。IronPDF Java依賴已發布在Maven Central上，並需要Java 8或更高版本。

 :title=Replace Text on First Page
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-single-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key (required for production use)
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Render HTML content into a PDF document
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");

        // Define the search and replacement strings
        String oldText = ".NET6";
        String newText = ".NET7";

        // Replace all instances of oldText on the first page only
        // PageSelection.firstPage() targets page index 0
        pdf.replaceText(PageSelection.firstPage(), oldText, newText);

        // Save the modified PDF
        pdf.saveAs("replaceText.pdf");
    }
}

 :title=Replace Text on First Page
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-single-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key (required for production use)
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Render HTML content into a PDF document
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");

        // Define the search and replacement strings
        String oldText = ".NET6";
        String newText = ".NET7";

        // Replace all instances of oldText on the first page only
        // PageSelection.firstPage() targets page index 0
        pdf.replaceText(PageSelection.firstPage(), oldText, newText);

        // Save the modified PDF
        pdf.saveAs("replaceText.pdf");
    }
}

replaceText方法與IronPDF的HTML到PDF轉換工作流自然整合。 首先渲染HTML模板，然後應用文字替換以注入動態值。 這樣可以保持HTML清潔，同時產出個性化輸出。 對於從磁碟載入的文件，請將檔案路徑傳遞給renderHtmlAsPdf。

輸出看起來如何？

使用頁面列表時會修改哪些頁面？

在下面的例子中，從HTML建立了一個三頁的PDF。 替換在頁面2（第一和第三頁）上運行。 頁面1（第二頁）保持原文不變。 頁面索引總是從0開始，與Java的零基數陣列約定一致。

 :title=Replace Text on Multiple Specific Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Build a 3-page PDF from HTML using CSS page breaks
        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>";

        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

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

        // Pages are zero-indexed: 0 = first page, 2 = third page
        // Page index 1 (second page) is intentionally excluded
        List<Integer> pages = Arrays.asList(0, 2);

        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

 :title=Replace Text on Multiple Specific Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Build a 3-page PDF from HTML using CSS page breaks
        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>";

        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

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

        // Pages are zero-indexed: 0 = first page, 2 = third page
        // Page index 1 (second page) is intentionally excluded
        List<Integer> pages = Arrays.asList(0, 2);

        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

在從HTML建立多頁PDF時，使用CSS page-break-after 屬性來控制頁面邊界的位置。 在渲染前設置合適的自定義紙張尺寸和頁面方向可確保在執行文字替換時內容位置符合您的預期。 保存後，打開PDF並確認只有目標頁面發生了變化來驗證輸出。

輸出看起來如何？

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones

首席軟體工程師，Agorus Build

查看案例研究

哪些方法針對單頁與多頁？

什麼時候應該使用每個PageSelection方法？

allPages()是全域查找和替換的最簡選擇：整個文件中目標文字的每個實例都在一次調用中被替換。 使用lastPage()進行快速編輯，以覆蓋頁面或最後頁頁腳而不觸碰主體。 當文字出現在一系列連續頁面如章節或段落時選擇pageRange(int, int)。 當目標頁面是不連續的時使用pageRange(List<Integer>)； 例如，當替換僅在第1頁、第3頁和第7頁出現的版本字串時。

處理合併的PDF或包含書籤和大綱的文件時，首先識別每個邏輯部分的頁面範圍，然後應用目標替換以避免意外修改共享的標題或頁腳。 IronPDF for Java API參考列出所有PageSelection重載，並附有完整的參數說明。

如何一次替換所有頁面的文字？

PageSelection.allPages()在一次調用中執行整個文件的替換，這是全球標記替換的最有效方法。 下面的例子從磁碟載入一個PDF，並替換整個文件中每次出現的占位符標記：

 :title=Replace Text on All Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.nio.file.Paths;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("contract-template.pdf"));

        // Replace the placeholder token on every page simultaneously
        // This is equivalent to calling replaceText for each page individually
        pdf.replaceText(PageSelection.allPages(), "{{VERSION}}", "2.0");

        // Save the updated document
        pdf.saveAs("contract-v2.pdf");
    }
}

 :title=Replace Text on All Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.nio.file.Paths;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("contract-template.pdf"));

        // Replace the placeholder token on every page simultaneously
        // This is equivalent to calling replaceText for each page individually
        pdf.replaceText(PageSelection.allPages(), "{{VERSION}}", "2.0");

        // Save the updated document
        pdf.saveAs("contract-v2.pdf");
    }
}

這種模式自然地與模板驅動的工作流搭配使用，其中相同的占位符在許多頁面上的標題、頁腳或正文中出現。 對於單頁文件，firstPage()生成相同的結果。 在頁面數可能在運行時變化時偏好allPages()。

大小寫敏感匹配如何影響結果？

replaceText執行精確的、區分大小寫的匹配。 字串"VERSION 1.0"被視為三個不同的值。 在對從磁碟載入的文件運行替換之前，通過查看原始來源或從PDF提取文字並以程式方式檢查來確認精確大小寫。

如何在PDF表單中替換文字？

包含互動表單欄位的PDF根據PDF規範將其文字值儲存在文件的內容流之外。 replaceText方法在內容流上運行，並不修改表單欄位值。 要更新表單欄位內的文字，請改用IronPDF的專用表單建立和編輯API。 在同一文件中混合使用這兩種方法是安全的：表單欄位更新和內容流替換不會相互干擾。

如何在基於模板的工作流中更新文字？

常見模式是維護含有占位符標記的PDF模板（例如[INVOICE_DATE]），並在運行時用實際值替換它們。 為每個占位符調用PageSelection.allPages()以便替換包括標記出現的每個位置。 對於從HTML生成的文件，這種工作流使用renderHtmlAsPdf，然後再進行一系列替換調用，一樣有效。 將此與PDF浮水印或背景和前景結合使用，以在最終輸出中新增品牌或保密標記。