Como substituir texto em um PDF

Quais páginas são modificadas ao usar uma lista de páginas?

No exemplo abaixo, um PDF de três páginas é gerado a partir de HTML. A substituição é executada nas páginas 0 e 2 (a primeira e a terceira páginas). A página 1 (a segunda página) mantém o texto original inalterado. Os índices de página sempre começam em 0, em conformidade com as convenções de arrays baseados em zero do Java.

```java :title=Substituir texto em várias páginas específicas //:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java import IronPDF.*; import IronPDF; import java.io.IOException; import java.util.Arrays; import java.util.List;

public class App {

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

    // Configure a chave de licença do IronPDF
    License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

    // Construa um PDF de 3 páginas a partir do HTML usando quebras de página CSS
    String html = &quot;<p> .NET6</p> &quot; +
                  "<p> Esta é a 1ª Página </p>" +
                  "<div style="page-break-after:> always;"></div>" +
                  "<p> Esta é a 2ª Página</p>" +
                  "<div style="page-break-after:> always;"></div>" +
                  &quot;<p> .NET6</p> &quot; +
                  "<p> Esta é a 3ª Página</p>";

    PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

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

    // Páginas são indexadas a partir de zero: 0 = primeira página, 2 = terceira página
    // Índice da página 1 (segunda página) é intencionalmente excluído
    Lista<Integer> páginas = Arrays.asList(0, 2);

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

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

}

ObserveTodos os índices de página no IronPDF seguem a indexação baseada em zero. A página `0` é a primeira página, a página `1` é a segunda, e assim por diante.

Ao criar PDFs com várias páginas a partir de HTML, use a [propriedade CSS `page-break-after`](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after) para controlar onde os limites da página serão definidos. Definir o [tamanho de papel personalizado](https://ironpdf.com/java/examples/custom-pdf-paper-size/) e a [orientação da página](https://ironpdf.com/java/examples/pdf-page-orientation/) corretos antes de renderizar garante que as posições do conteúdo correspondam às suas expectativas quando a substituição de texto for executada. Após salvar, verifique a saída abrindo o PDF e confirmando que apenas as páginas direcionadas foram alteradas.

### Qual é a aparência do resultado?

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

<hr>

## Quais opções de seleção de página estão disponíveis?

A classe `PageSelection` fornece métodos de fábrica estáticos que abrangem todos os padrões de direcionamento comuns. Nenhuma criação de instância é necessária; chame os métodos diretamente na classe. Todos os índices são baseados em zero.

### Quais métodos direcionam página única vs. múltiplas páginas?

<table class="content__data-table" data-content-table>
<caption>Métodos da fábrica PageSelection para a API replaceText</caption>

| Método | Descrição |
|---|---|
| `PageSelection.allPages()` | Seleciona todas as páginas no documento |
| `PageSelection.firstPage()` | Seleciona a página no índice `0` |
| `PageSelection.lastPage()` | Seleciona a página final independentemente do comprimento do documento |
| `PageSelection.singlePage(int pageIndex)` | Seleciona uma página específica pelo índice baseado em zero |
| `PageSelection.pageRange(int startIndex, int endIndex)` | Seleciona um intervalo contíguo de `startIndex` a `endIndex` inclusive |
| `PageSelection.pageRange(List<Integer> pageList)` | Seleciona páginas em qualquer conjunto arbitrário de índices (por exemplo, `[0, 2]` seleciona as páginas 1 e 3) |

</table>

### Quando devo usar cada método de seleção de página?

`allPages()` é a opção mais simples para uma busca e substituição global: todas as ocorrências do texto alvo em todo o documento são substituídas em uma única chamada. Use `firstPage()` ou `lastPage()` para edições rápidas em capas ou rodapés da última página sem alterar o corpo do texto. Selecione `pageRange(int, int)` quando o texto aparecer em um conjunto sequencial de páginas, como um capítulo ou seção. Use `pageRange(List<Integer>)` quando as páginas de destino não forem contíguas; por exemplo, ao substituir uma string de versão que aparece apenas nas páginas 1, 3 e 7.

Ao trabalhar com [PDFs mesclados](https://ironpdf.com/java/examples/split-pdfs/) ou documentos que incluem [marcadores e esboços](https://ironpdf.com/java/how-to/bookmarks/), identifique a faixa de páginas para cada seção lógica primeiro, depois aplique substituições direcionadas para evitar modificar cabeçalhos ou rodapés compartilhados acidentalmente. A [referência da API IronPDF for Java](https://ironpdf.com/object-reference/api/) lista todas as sobrecargas `PageSelection` com documentação completa dos parâmetros.

ImportanteEnvolva as chamadas `replaceText` em um bloco try-catch. O método lança uma exceção de tempo de execução quando o texto de busca especificado não é encontrado em nenhuma das páginas alvo. Um passo de validação (extraindo texto e confirmando se a string está presente) previne falhas inesperadas em produção.

### Como substituir texto em todas as páginas de uma vez?

`PageSelection.allPages()` realiza uma substituição em todo o documento em uma única chamada, que é a abordagem mais eficiente para substituição global de tokens. O exemplo abaixo carrega um PDF do disco e substitui todas as ocorrências de um token de marcador em todo o documento:

```java :title=Substituir texto em todas as páginas
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import IronPDF.*;
import IronPDF;
import java.io.IOException;
importação java.nio.file.Paths;

public class App {

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

        // Configure a chave de licença do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Carregue um PDF existente do disco
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(&quot;contract-template.pdf&quot;));

        // Substitua o token de marcador em cada página simultaneamente
        // Isso é equivalente a chamar replaceText para cada página individualmente
        pdf.replaceText(PageSelection.allPages(), &quot;{{VERSION}}&quot;, &quot;2.0&quot;);

        // Salve o documento atualizado
        pdf.saveAs(&quot;contract-v2.pdf&quot;);
    }
}

Este padrão combina-se naturalmente com fluxos de trabalho orientados por templates onde o mesmo marcador aparece em cabeçalhos, rodapés ou textos do corpo em muitas páginas. Para documentos de página única, allPages() e firstPage() produzem resultados idênticos. Prefira allPages() quando a contagem de páginas puder variar em tempo de execução.

Como a correspondência que diferencia maiúsculas de minúsculas afeta os resultados?

replaceText realiza correspondência exata, diferenciando maiúsculas de minúsculas. As sequências "Version 1.0", "version 1.0" e "VERSION 1.0" são tratadas como três valores distintos. Antes de executar uma substituição em um documento carregado do disco, confirme a exata diferenciação de maiúsculas e minúsculas revisando a fonte original ou extraindo texto do PDF e inspecionando-o programaticamente.

Como substituir texto em formulários de PDF?

PDFs que contêm campos de formulário interativos armazenam seus valores de texto separadamente do fluxo de conteúdo do documento, conforme definido na especificação PDF. O método replaceText opera no fluxo de conteúdo e não modifica os valores dos campos do formulário. Para atualizar texto dentro de campos de formulário, use a API de criação e edição de formulários dedicada do IronPDF. Misturar ambas abordagens no mesmo documento é seguro: atualizações em campos de formulário e substituições no fluxo de conteúdo não interferem entre si.

Como atualizar texto em fluxos de trabalho baseados em templates?

Um padrão comum é manter um modelo de PDF com marcadores de posição (por exemplo, {{CUSTOMER_NAME}} ou [INVOICE_DATE]) e substituí-los em tempo de execução por valores reais. Chame replaceText uma vez por marcador de posição, usando PageSelection.allPages() para que a substituição cubra todos os locais onde o token aparece. Para documentos gerados a partir de HTML, esse fluxo de trabalho funciona igualmente bem com renderHtmlAsPdf seguido por uma série de chamadas de substituição. Combine isso com marca d'água em PDF ou fundos e primeiros planos para adicionar marcas de marcação ou confidencialidade à saída final.