如何替换 PDF 中的文本

replaceText 需要哪些参数？

```java :title=替换文本示例 import com.ironsoftware.IronPdf.*； import com.ironsoftware.IronPdf.edit.PageSelection； 导入 java.io.IOException；

/**

• 主要应用类，用于演示如何替换 PDF 中的文本。 */ 公共类 App {

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

  // 设置 IronPdf 许可证密钥 - 生产使用所需的密钥
  License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01")；
  
  // 将 HTML 内容渲染为 PDF
  // 从 HTML 内容创建新的 PDF
  PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");
  
  // 定义要替换的新旧文本
  String oldText = ".NET6"；  // 要搜索的文本
  字符串 newText = ".NET7"；  // 替换文本
  
  // 在第一页用 newText 替换所有 oldText 实例
  // PageSelection.firstPage() 仅针对第一页(索引 0)
  pdf.replaceText(PageSelection.firstPage(), oldText, newText)；
  
  // 保存生成的 PDF 文档
  pdf.saveAs("replaceText.pdf")；

  } }

replaceText 方法默认执行区分大小写的匹配。 "net6 "和 "NET6 "被视为不同的字符串。 在使用 HTML 到 PDF 的转换时，请确保您的搜索文本与渲染后的 PDF 中的显示方式完全匹配。 对于更高级的文本操作，可以考虑 从 PDF 中提取文本，以便在替换之前验证内容。

输出结果是什么样的？

哪些页面可以进行文本替换？

import com.ironsoftware.IronPdf.*；
import com.ironsoftware.IronPdf.edit.PageSelection；
导入 java.io.IOException；
import java.util.Arrays;
import java.util.List;

/**
 * Main application class for demonstrating how to replace text on multiple pages of a PDF.
 */
公共类 App {

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

        // Set the IronPDF license key - see https://ironpdf.com/java/licensing/
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01")；

        // HTML content that will be converted to a 3-page PDF
        // Page breaks are created using CSS page-break-after property
        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>";

        // Render the HTML content into a PDF
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        // 定义要替换的新旧文本
        String oldText = ".NET6"；
        字符串 newText = ".NET7"；

        // Define the pages where text replacement should occur 
        // Page numbers are zero-indexed: 0 = first page, 2 = third page
        List<Integer> pages = Arrays.asList(0, 2);

        // Replace the text on specified pages only
        // The second page (index 1) will remain unchanged
        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        // 保存生成的 PDF 文档
        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

import com.ironsoftware.IronPdf.*；
import com.ironsoftware.IronPdf.edit.PageSelection；
导入 java.io.IOException；
import java.util.Arrays;
import java.util.List;

/**
 * Main application class for demonstrating how to replace text on multiple pages of a PDF.
 */
公共类 App {

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

        // Set the IronPDF license key - see https://ironpdf.com/java/licensing/
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01")；

        // HTML content that will be converted to a 3-page PDF
        // Page breaks are created using CSS page-break-after property
        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>";

        // Render the HTML content into a PDF
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        // 定义要替换的新旧文本
        String oldText = ".NET6"；
        字符串 newText = ".NET7"；

        // Define the pages where text replacement should occur 
        // Page numbers are zero-indexed: 0 = first page, 2 = third page
        List<Integer> pages = Arrays.asList(0, 2);

        // Replace the text on specified pages only
        // The second page (index 1) will remain unchanged
        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        // 保存生成的 PDF 文档
        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

从 HTML 创建多页 PDF 时，了解 自定义 PDF 页面大小和 页面方向设置有助于在应用文本替换之前确保内容在所有页面上正确显示。

当我在替换过程中跳过页面时会发生什么？

哪些方法针对单个页面与多个页面？

• allPages: 选择 PDF 的所有页面
• firstPage: 选择 PDF 的第一页
• lastPage: 选择 PDF 的最后一页
• pageRange(int startIndex, int endIndex): 指定页面范围(例如，0 到 2 选择页面 3)
• pageRange(List<Integer> pageList): 从列表中选择特定页面(例如，[0, 2] 选择页面 1 和 3)
• singlePage(int pageIndex): 指定 PDF 的单页。

何时应使用每种 PageSelection 方法？

使用 firstPage() 或 lastPage() 可以快速编辑文档的页眉和页脚。 更新多个连续页面(如章节)时，请选择 pageRange()。 选择 singlePage() 进行针对性更正，应用 allPages() 对整个文档进行全局查找和替换操作。

使用合并的 PDF时，请使用 pageRange() 仅更新特定源文档中的页面。 同样，在处理带有书签和大纲的文档时，应使用其页面范围锁定特定章节。