Jak zastąpić tekst w pliku PDF

Które strony są modyfikowane podczas korzystania z listy stron?

W poniższym przykładzie z kodu HTML tworzony jest trzy stronicowy plik PDF. Zastąpienie dotyczy stron 0 i 2 (pierwsza i trzecia strona). Strona 1 (druga strona) zachowuje oryginalny tekst bez zmian. Indeksy stron zawsze zaczynają się od 0, zgodnie z konwencjami tablic w języku Java, gdzie indeksowanie zaczyna się od zera.

```java :title=Zastąp tekst na wielu określonych stronach //: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 {

    // Ustaw klucz licencyjny IronPDF
    License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

    // Utwórz 3-stronicowy plik PDF z HTML przy użyciu podziałów stron CSS
    String html = &quot;<p> .NET6 </p>&quot; +
                  &quot;<p> To jest pierwsza strona </p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> To jest strona 2</p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> .NET6 </p>&quot; +
                  &quot;<p> To jest strona trzecia</p>&quot;;

    PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

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

    // Strony są indeksowane od zera: 0 = pierwsza strona, 2 = trzecia strona
    // Indeks strony 1 (druga strona) został celowo pominięty
    List<integer> pages = Arrays.asList(0, 2);</integer>

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

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

}

Zwróć uwagęWszystkie indeksy stron w IronPDF stosują indeksowanie od zera. Strona `0` jest pierwszą stroną, strona `1` jest drugą i tak dalej.

Podczas tworzenia wielostronicowych plików PDF z HTML należy użyć [właściwości](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after) [CSS `page-break-after`](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after), aby kontrolować rozmieszczenie granic stron. Ustawienie odpowiedniego [niestandardowego rozmiaru papieru](https://ironpdf.com/java/examples/custom-pdf-paper-size/) i [orientacji strony](https://ironpdf.com/java/examples/pdf-page-orientation/) przed renderowaniem gwarantuje, że po uruchomieniu funkcji zamiany tekstu pozycje treści będą zgodne z oczekiwaniami. Po zapisaniu sprawdź wynik, otwierając plik PDF i upewniając się, że zmieniono tylko docelowe strony.

### Jak wygląda wynik?

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

<hr>

## Jakie opcje wyboru stron są dostępne?

Klasa `PageSelection` udostępnia statyczne metody fabryczne, które obejmują wszystkie typowe wzorce kierowania. Nie jest wymagane tworzenie instancji; wywołać metody bezpośrednio w klasie. Wszystkie indeksy są liczone od zera.

### Które metody są przeznaczone dla pojedynczych stron, a które dla wielu stron?

<table class="content__data-table" data-content-table>
<caption>Metody fabryczne PageSelection dla interfejsu API replaceText</caption>

| Metoda | Opis |
|---|---|
| `PageSelection.allPages()` | Wybiera każdą stronę w dokumencie |
| `PageSelection.firstPage()` | Wybiera stronę w indeksie `0` |
| `PageSelection.lastPage()` | Wybiera ostatnią stronę niezależnie od długości dokumentu |
| `PageSelection.singlePage(int pageIndex)` | Wybiera jedną konkretną stronę według indeksu zaczynającego się od zera |
| `PageSelection.pageRange(int startIndex, int endIndex)` | Wybiera ciągły zakres od `startIndex` do `endIndex` włącznie |
| `PageSelection.pageRange(List<Integer> pageList)` | Wybiera strony o dowolnym zestawie indeksów (np. `[0, 2]` wybiera strony 1 i 3) |

</table>

### Kiedy należy używać poszczególnych metod PageSelection?

`allPages()` to najprostszy wybór do globalnego wyszukiwania i zamiany: każde wystąpienie tekstu docelowego w całym dokumencie jest zamieniane za pomocą jednego wywołania. Użyj `firstPage()` lub `lastPage()` do szybkich zmian na stronach tytułowych lub stopkach ostatniej strony bez ingerencji w treść. Wybierz `pageRange(int, int)`, gdy tekst pojawia się na sekwencyjnym zestawie stron, takim jak rozdział lub sekcja. Użyj `pageRange(List<Integer>)`, gdy strony docelowe nie są połączone; na przykład podczas zastępowania ciągu znaków wersji, który pojawia się tylko na stronach 1, 3 i 7.

W przypadku pracy ze [scalonymi plikami PDF](https://ironpdf.com/java/examples/split-pdfs/) lub dokumentami zawierającymi [zakładki i spisy treści](https://ironpdf.com/java/how-to/bookmarks/) należy najpierw zidentyfikować zakres stron dla każdej sekcji logicznej, a następnie zastosować ukierunkowane zamiany, aby uniknąć przypadkowej modyfikacji wspólnych nagłówków lub stopek. [Dokumentacja API IronPDF for Java](https://ironpdf.com/object-reference/api/) zawiera listę wszystkich nadładowań `PageSelection` wraz z pełną dokumentacją parametrów.

WażneZawijaj wywołania `replaceText` w bloku try-catch. Metoda ta generuje wyjątek wykonania, gdy podany tekst wyszukiwania nie zostanie znaleziony na żadnej z docelowych stron. Etap walidacji (wyodrębnianie tekstu i sprawdzanie obecności ciągu znaków) zapobiega nieoczekiwanym awariom w środowisku produkcyjnym.

### Jak zastąpić tekst na wszystkich stronach jednocześnie?

`PageSelection.allPages()` wykonuje zamianę w całym dokumencie za pomocą jednego wywołania, co jest najbardziej wydajnym podejściem do globalnej zamiany tokenów. Poniższy przykład ładuje plik PDF z dysku i zastępuje wszystkie wystąpienia tokenu zastępczego w całym dokumencie:

```java :title=Zastąp tekst na wszystkich stronach
//: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 {

        // Ustaw klucz licencyjny IronPDF
        License.setLicenseKey(&quot;IronPDF-MYLICENSE-KEY-1EF01&quot;);

        // Wczytaj istniejący plik PDF z dysku
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(&quot;contract-template.pdf&quot;));

        // Zastąp token zastępczy na wszystkich stronach jednocześnie
        // Jest to równoważne z wywołaniem funkcji replaceText dla każdej strony z osobna
        pdf.replaceText(PageSelection.allPages(), &quot;{{VERSION}}&quot;, &quot;2.0&quot;);

        // Zapisz zaktualizowany dokument
        pdf.saveAs(&quot;contract-v2.pdf&quot;);
    }
}

Ten wzorzec naturalnie łączy się z procesami opartymi na szablonach, w których ten sam symbol zastępczy pojawia się w nagłówkach, stopkach lub treści na wielu stronach. W przypadku dokumentów jednostronicowych allPages() i firstPage() dają identyczne wyniki. Preferuj allPages(), gdy liczba stron może się zmieniać w czasie wykonywania.

Jak dopasowanie z uwzględnieniem wielkości liter wpływa na wyniki?

replaceText wykonuje dokładne dopasowanie z uwzględnieniem wielkości liter. Ciągi znaków "Version 1.0", "version 1.0" i "VERSION 1.0" są traktowane jako trzy odrębne wartości. Przed uruchomieniem zamiany w dokumencie załadowanym z dysku należy potwierdzić dokładną wielkość liter, sprawdzając oryginalne źródło lub wyodrębniając tekst z pliku PDF i sprawdzając go programowo.

Jak zastąpić tekst w formularzach PDF?

Pliki PDF zawierające interaktywne pola formularzy przechowują wartości tekstowe oddzielnie od strumienia treści dokumentu, zgodnie z definicją w specyfikacji PDF. Metoda replaceText działa na strumieniu treści i nie modyfikuje wartości pól formularza. Aby zaktualizować tekst w polach formularza, należy zamiast tego użyć dedykowanego interfejsu API IronPDF do tworzenia i edycji formularzy. Połączenie obu podejść w tym samym dokumencie jest bezpieczne: aktualizacje pól formularzy i zamiany strumienia treści nie zakłócają się nawzajem.

Jak zaktualizować tekst w przepływach pracy opartych na szablonach?

Często spotykanym rozwiązaniem jest utrzymywanie szablonu PDF z tokenami zastępczymi (na przykład {{CUSTOMER_NAME}} lub [INVOICE_DATE]) i zastępowanie ich w czasie wykonywania rzeczywistymi wartościami. Wywołaj replaceText raz na każdy symbol zastępczy, używając PageSelection.allPages(), aby zamiana objęła wszystkie miejsca, w których pojawia się token. W przypadku dokumentów generowanych z HTML ten proces działa równie dobrze z renderHtmlAsPdf, po którym następuje seria wywołań zastępczych. Połącz to z dodawaniem znaków wodnych do plików PDF lub tłem i pierwszym planem, aby dodać oznaczenia marki lub poufności do końcowego wyniku.