Ersetzen von Text in einer PDF-Datei

Welche Parameter akzeptiert replaceText?

Die Methodensignatur ist replaceText(PageSelection pageSelection, String oldText, String newText). Das Matching ist standardmäßig groß-/kleinbuchstabensensitiv: "net6" und "NET6" werden als unterschiedliche Zeichenfolgen behandelt. Überprüfen Sie die genaue Groß- und Kleinschreibung im gerenderten PDF, bevor Sie die Methode aufrufen. Sie können den genauen Text bestätigen, indem Sie zuerst den Textinhalt des PDFs extrahieren. Die IronPDF Java-Abhängigkeit wird auf Maven Central veröffentlicht und erfordert Java 8 oder höher.

 :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");
    }
}

Die Methode replaceText integriert sich natürlich in IronPDFs HTML zu PDF-Konvertierungsworkflow. Rendern Sie zuerst die HTML-Vorlage und wenden Sie dann die Textersetzung an, um dynamische Werte einzufügen. Dies hält Ihr HTML sauber und erzeugt dennoch personalisierte Ausgaben. Für von der Festplatte geladene Dokumente, übergeben Sie den Dateipfad an PdfDocument.fromFile anstelle von renderHtmlAsPdf.

Wie sieht die Ausgabe aus?

Welche Seiten werden modifiziert, wenn Sie eine Seitenliste verwenden?

Im folgenden Beispiel wird ein dreiseitiges PDF aus HTML erstellt. Der Austausch erfolgt auf den Seiten 0 und 2 (die erste und die dritte Seite). Seite 1 (die zweite Seite) behält den ursprünglichen Text unverändert bei. Seitenindizes beginnen immer bei 0, was mit den nullbasierten Array-Konventionen von Java übereinstimmt.

 :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");
    }
}

Wenn Sie mehrseitige PDFs aus HTML erstellen, verwenden Sie die CSS page-break-after-Eigenschaft, um zu steuern, wo Seitenumbrüche erfolgen. Das richtige individuelle Papierformat und die Ausrichtung der Seite vor dem Rendern festzulegen, stellt sicher, dass die Inhaltspositionen Ihren Erwartungen entsprechen, wenn der Textersatz durchgeführt wird. Nach dem Speichern überprüfen Sie die Ausgabe, indem Sie das PDF öffnen und bestätigen, dass nur die zielgerichteten Seiten geändert wurden.

Wie sieht die Ausgabe aus?

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

Welche Methoden zielen auf einzelne vs. mehrere Seiten?

Wann sollte ich jede PageSelection-Methode verwenden?

allPages() ist die einfachste Wahl für ein globales Finden und Ersetzen: jede Instanz des Zieltexts im gesamten Dokument wird in einem Aufruf ersetzt. Verwenden Sie firstPage() oder lastPage() für schnelle Bearbeitungen, um Titelseiten oder Fußzeilen der letzten Seite zu decken, ohne den Rumpf zu berühren. Wählen Sie pageRange(int, int), wenn der Text auf einem fortlaufenden Satz von Seiten wie einem Kapitel oder Abschnitt erscheint. Verwenden Sie pageRange(List<Integer>), wenn die Zielseiten nicht zusammenhängend sind; zum Beispiel beim Ersetzen einer Versionskennung, die nur auf den Seiten 1, 3 und 7 erscheint.

Bei der Arbeit mit zusammengeführten PDFs oder Dokumenten, die Lesezeichen und Gliederungen enthalten, identifizieren Sie zuerst den Seitenbereich für jede logische Sektion, dann wenden Sie gezielte Ersetzungen an, um versehentliche Änderungen an gemeinsamen Kopf- oder Fußzeilen zu vermeiden. Die IronPDF for Java API-Referenz listet alle PageSelection-Überladungen mit vollständiger Parameterdokumentation auf.

Wie ersetze ich Text auf allen Seiten auf einmal?

PageSelection.allPages() führt in einem einzigen Aufruf einen dokumentweiten Ersatz durch, was der effizienteste Ansatz für den globalen Tokenersatz ist. Das folgende Beispiel lädt ein PDF von der Festplatte und ersetzt jedes Vorkommen eines Platzhalters im gesamten Dokument:

 :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");
    }
}

Dieses Muster passt natürlich zu vorlagengetriebenen Arbeitsabläufen, bei denen derselbe Platzhalter in Kopfzeilen, Fußzeilen oder Fließtext auf vielen Seiten erscheint. Für einseitige Dokumente produzieren allPages() und firstPage() identische Ergebnisse. Bevorzugen Sie allPages(), wenn die Seitennummer zur Laufzeit variieren kann.

Wie beeinflusst fall-sensitive Übereinstimmung die Ergebnisse?

replaceText führt exakte, groß-/kleinbuchstabensensitive Übereinstimmungen durch. Die Zeichenfolgen "Version 1.0", "version 1.0" und "VERSION 1.0" werden als drei unterschiedliche Werte behandelt. Bevor Sie eine Ersetzung auf ein von der Festplatte geladenes Dokument durchführen, überprüfen Sie die exakte Schreibweise, indem Sie die Originalquelle prüfen oder Text aus dem PDF extrahieren und es programmatisch überprüfen.

Wie ersetze ich Text in PDF-Formularen?

PDFs, die interaktive Formularfelder enthalten, speichern ihre Textwerte getrennt vom Inhaltsstrom des Dokuments, wie in der PDF-Spezifikation definiert. Die Methode replaceText arbeitet an den Inhaltsströmen und ändert keine Formularfeldwerte. Um Text in Formularfeldern zu aktualisieren, verwenden Sie stattdessen die Formularerstellungs- und Bearbeitungs-API von IronPDF. Das Mischen beider Ansätze im selben Dokument ist sicher: Formularfeld-Updates und Inhaltsstrom-Ersetzungen stören sich nicht gegenseitig.

Wie aktualisiere ich Text in vorlagenbasierten Arbeitsabläufen?

Ein gängiges Muster besteht darin, eine PDF-Vorlage mit Platzhalter-Token aufrechtzuerhalten (zum Beispiel {{CUSTOMER_NAME}} oder [INVOICE_DATE]) und sie zur Laufzeit durch die tatsächlichen Werte zu ersetzen. Rufen Sie replaceText einmal pro Platzhalter auf, und verwenden Sie PageSelection.allPages(), damit der Ersatz jede Stelle abdeckt, an der das Token erscheint. Für Dokumente, die aus HTML generiert werden, funktioniert dieses Workflow genauso gut mit renderHtmlAsPdf gefolgt von einer Reihe von Ersatzaufrufen. Kombinieren Sie dies mit PDF-Wasserzeichen oder Hintergründen und Vordergründen, um Marken- oder Vertraulichkeitskennzeichnungen zum endgültigen Ergebnis hinzuzufügen.