如何在 PDF/A 中替换文本

使用页面列表时会修改哪些页面？

在下面的示例中，将 HTML 转换为三页的 PDF 文件。 替换内容位于第 0 和 2 页（即第一页和第三页）。 第 1 页（即第二页）保留原文不变。 页面索引始终从 0 开始，这与 Java 的零基数数组惯例保持一致。

```java :title=在多个指定页面上替换文本 //: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.IO/Exception; import java.util.Arrays; import java.util.List;

public class App {

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

    // 设置 IronPDF 许可证密钥
    License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

    // 使用 CSS 分页功能将 HTML 生成 3 页的 PDF
    String html = &quot;<p> .NET 6 </p>&quot; +
                  &quot;<p> 这是第 1 页 </p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> 这是第2页</p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> .NET 6 </p>&quot; +
                  &quot;<p> 这是第3页</p>&quot;;

    PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

    String oldText = &quot;.NET6&quot;;
    String newText = &quot;.NET7&quot;;

    // 页面从 0 开始计数：0 = 第一页，2 = 第三页
    // 页面索引 1（第二页）已刻意省略
    List<integer> pages = Arrays.asList(0, 2);</integer>

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

    pdf.saveAs(&quot;replaceTextOnMultiplePages.pdf&quot;);
}

}

请注意IronPdf 中所有页面索引均采用从零开始的索引方式。 第 `0` 页为第一页，第 `1` 页为第二页，依此类推。）}]

在将 HTML 转换为多页 PDF 时，请使用 [CSS `page-break-after` 属性](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after)来控制页面分界点的位置。 在渲染前设置正确的[自定义纸张尺寸](https://ironpdf.com/java/examples/custom-pdf-paper-size/)和[页面方向](https://ironpdf.com/java/examples/pdf-page-orientation/)，可确保在执行文本替换时，内容位置符合您的预期。 保存后，请打开 PDF 文件进行验证，确认仅目标页面发生了更改。

### 翻译后的效果应如何呈现？

<iframe loading="lazy" src="/static-assets/ironpdf-java/howto/find-replace-text/replaceTextOnMultiplePages.pdf" width="100%" height="400px"></iframe>

<hr>

## 有哪些页面选择选项？

`PageSelection` 类提供了静态工厂方法，涵盖了所有常见的定位模式。 无需创建实例； 直接在类上调用这些方法。 所有索引均从零开始。

### 哪些方法适用于单页，哪些适用于多页？

<table class="content__data-table" data-content-table>
<caption>replaceText API 的 PageSelection 工厂方法</caption>

| 方法 | 描述 |
|---|---|
| `PageSelection.allPages()` | 选中文档中的所有页面 |
| `PageSelection.firstPage()` | 在索引中选择页面 `0` |
| `PageSelection.lastPage()` | 无论文档长度如何，均选择最后一页 |
| `PageSelection.singlePage(int pageIndex)` | 通过零起始索引选择特定页面 |
| `PageSelection.pageRange(int startIndex, int endIndex)` | 选择从 `startIndex` 到 `endIndex`（含）的连续范围 |
| `PageSelection.pageRange(List<Integer> pageList)` | 选择任意索引范围内的页面（例如，`[0, 2]` 选择第 1 页和第 3 页） |

</table>

### 何时应使用哪种 PageSelection 方法？

`allPages()` 是进行全局查找和替换的最简便选择：只需一次调用，即可将整个文档中所有目标文本实例替换为指定内容。 使用 `firstPage()` 或 `lastPage()` 进行快速编辑，以修改封面页或末页页脚，同时不影响正文内容。 当文本出现在章节或小节等连续页面中时，请选择 `pageRange(int, int)`。 当目标页面内容不连续时，请使用 `pageRange(List<Integer>)`； 例如，当替换仅出现在第 1、3 和 7 页的版本字符串时。

处理[合并](https://ironpdf.com/java/examples/split-pdfs/)的[ PDF](https://ironpdf.com/java/examples/split-pdfs/) 或包含[书签和目录](https://ironpdf.com/java/how-to/bookmarks/)的文档时，请先确定每个逻辑部分的页码范围，然后进行有针对性的替换，以避免意外修改共享的页眉或页脚。 [IronPDF for Java API 参考文档](https://ironpdf.com/object-reference/api/)列出了所有 `PageSelection` 重载方法，并附有完整的参数说明。

重要将 `replaceText` 调用包裹在 try-catch 块中。 当在目标页面中均未找到指定的搜索文本时，该方法会抛出运行时异常。 验证步骤（提取文本并确认字符串存在）可防止生产环境中出现意外故障。）}]

### 如何一次性替换所有页面上的文本？

`PageSelection.allPages()` 通过单次调用即可实现全文档范围的替换，这是进行全局标记替换的最有效方法。 下面的示例从磁盘加载一个 PDF 文件，并替换文档中所有出现的占位符：

```java :title=在所有页面上替换文本
//: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.IO/Exception;
import java.nio.file.Paths;

public class App {

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

        // 设置 IronPDF 许可证密钥
        License.setLicenseKey(&quot;IronPDF-MYLICENSE-KEY-1EF01&quot;);

        // 从磁盘加载现有 PDF 文件
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(&quot;contract-template.pdf&quot;));

        // 同时替换所有页面上的占位符
        // 这相当于对每一页单独调用 replaceText
        pdf.replaceText(PageSelection.allPages(), &quot;{{VERSION}}&quot;, &quot;2.0&quot;);

        // 保存更新后的文档
        pdf.saveAs(&quot;contract-v2.pdf&quot;);
    }
}

此模式与基于模板的工作流天然契合，在该工作流中，同一占位符会出现在多页面的页眉、页脚或正文中。 对于单页文档，allPages() 和 firstPage() 会产生相同的结果。 当页面数量在运行时可能发生变化时，请优先使用 allPages()。

区分大小写的匹配会如何影响结果？

replaceText 执行精确且区分大小写的匹配。 字符串 "version 1.0" 和 "VERSION 1.0" 被视为三个独立的值。 在对从磁盘加载的文档执行替换操作之前，请通过查阅原始源文件，或从 PDF 中提取文本并进行程序化检查，以确认确切的大小写格式。

如何替换 PDF 表单中的文本？

根据 PDF 规范的定义，包含交互式表单字段的 PDF 文件会将文本值与文档内容流分开存储。 replaceText 方法作用于内容流，不会修改表单字段的值。 若需更新表单字段内的文本，请改用 IronPDF 专用的表单创建和编辑 API。 在同一文档中混合使用这两种方法是安全的：表单字段更新与内容流替换互不干扰。

如何在基于模板的工作流中更新文本？

一种常见的做法是维护一个包含占位符（例如 {{CUSTOMER_NAME}} 或 [INVOICE_DATE]）的 PDF 模板，并在运行时将其替换为实际值。 每个占位符调用一次 replaceText，并使用 PageSelection.allPages() 确保替换覆盖该标记出现的每个位置。 对于由 HTML 生成的文档，此工作流同样适用于 renderHtmlAsPdf 后跟一系列替换调用。 结合 PDF 水印或背景与前景功能，可在最终输出中添加品牌标识或保密标记。