PDF'deki Metni Nasıl Değiştiririm

replaceText Ne Tür Parametreler Kabul Eder?

Yöntem imzası replaceText(PageSelection pageSelection, String oldText, String newText). Eşleşme varsayılan olarak büyük/küçük harf duyarlıdır: "net6" ve "NET6" farklı dizgeler olarak kabul edilir. Yöntemi çağırmadan önce render edilmiş PDF'deki tam büyük/küçük harf kullanımını doğrulayın. Tam metni önce PDF'nin metin içeriğini ayıklayarak doğrulayabilirsiniz. IronPDF Java bağımlılığı Maven Central üzerinde yayımlanmıştır ve Java 8 veya daha sonraki sürümlerini gerektirir.

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

replaceText yöntemi, IronPDF'in HTML'den PDF'ye dönüştürme iş akışı ile doğal olarak bütünleşir. İlk olarak HTML şablonunu işleyin, ardından dinamik değerleri enjekte etmek için metin değişikliğini uygulayın. Bu, HTML'nin temiz kalmasını sağlarken kişiselleştirilmiş çıktılar üretir. Diskten yüklenen belgeler için, dosya yolunu PdfDocument.fromFile yerine renderHtmlAsPdf kullanarak geçirin.

Çıkış Nasıl Görünür?

Bir Sayfa Listesi Kullanıldığında Hangi Sayfalar Değiştirilir?

Aşağıdaki örnekte, HTML'den üç sayfalık bir PDF oluşturuluyor. Değiştirme, 0 ve 2 sayfalarında (ilk ve üçüncü sayfalar) çalışır. 1 sayfası (ikinci sayfa) orijinal metni değişmeden korur. Sayfa dizinleri her zaman 0 ile başlar, Java'nın sıfır tabanlı dizi gelenekleri ile tutarlılıktadır.

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

HTML'den çok sayfalı PDF'ler oluştururken, sayfa sınırlarının nerede düşeceğini kontrol etmek için CSS page-break-after özelliğini kullanın. özel kağıt boyutunu ve sayfa yönlendirmesini ayarlamak, içerik pozisyonlarının metin değişikliği çalıştığında beklentilerinize uygun olmasını sağlar. Kaydetme işleminden sonra, PDF'yi açarak ve sadece hedeflenen sayfaların değiştirildiğinden emin olarak çıktıyı doğrulayın.

Çıkış Nasıl Görünür?

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Tek Sayfa vs. Çoklu Sayfayı Hedefleyen Yöntemler Hangileri?

Hangi Durumlarda Her SayfaSelection Yöntemini Kullanmalıyım?

allPages(), küresel bir bul ve değiştir için en basit seçimdir: tüm belge boyunca hedef metnin her örneği tek bir çağrıda değiştirilir. Gövdeye dokunmadan kapak sayfalarını veya son-sayfa altbilgilerini kapsamak için hızlı düzenlemeler için firstPage() veya lastPage() kullanın. Metin, bir bölüm ya da bölüm gibi ardışık bir dizi sayfada göründüğünde pageRange(int, int) seçimi yapın. Hedef sayfalar süreksizse pageRange(List<Integer>) kullanın; örneğin, yalnızca sayfa 1, 3 ve 7'de görünen bir sürüm dizisi değiştirildiğinde.

Bölünmüş PDF'ler veya yer işaretleri ve anahatlar içeren belgelerle çalışırken, önce her mantıksal bölüm için sayfa aralığını belirleyin, ardından ortak başlık veya altbilgileri yanlışlıkla değiştirmekten kaçınmak için hedef değişiklikler uygulayın. IronPDF for Java API referansı tüm PageSelection aşırı yüklerini tam parametre belgeleri ile listeler.

Tüm Sayfalar Aynı Anda Nasıl Değiştirilir?

PageSelection.allPages(), tek bir çağrıda belge çapında bir değiştirme gerçekleştirir, bu da küresel bir simge değişimi için en etkili yaklaşımdır. Aşağıdaki örnek, diskteki bir PDF'yi yükler ve belgenin tamamındaki yer tutucu tokeninin her bir örneğini değiştirir:

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

Bu model, aynı yer tutucunun birçok sayfa üzerindeki başlıklar, altbilgiler veya gövde metinlerinde göründüğü şablon tarafından yönlendirilen iş akışlarıyla doğal olarak eşleşir. Tek sayfalı belgeler için, allPages() ve firstPage() aynı sonuçları üretir. Sayfa sayısının çalışma zamanında değişebileceği durumlarda allPages() tercih edin.

Büyük Harf Duyarlı Eşleştirme Sonuçları Nasıl Etkiler?

replaceText kesin, büyük/küçük harf duyarlı eşleştirme yapar. "Version 1.0", "version 1.0", ve "VERSION 1.0" dizgeleri üç farklı değer olarak kabul edilir. Diskten yüklenen bir belge üzerinde bir değiştirme çalıştırmadan önce, orijinal kaynağı gözden geçirerek veya PDF'den metin ayıklayarak ve programatik olarak inceleyerek tam büyük/küçük harf kullanımını doğrulayın.

PDF Formlarında Metin Nasıl Değiştirilir?

Etkileşimli form alanları içeren PDF'ler, metin değerlerini, PDF spesifikasyonunda tanımlandığı gibi, belgenin içerik akışından ayrı olarak saklar. replaceText yöntemi içerik akışında çalışır ve form alanı değerlerini değiştirmez. Form alanları içindeki metni güncellemek için, IronPDF'in ayrılmış form oluşturma ve düzenleme API'sini kullanın. Her iki yaklaşımı aynı belgede birleştirmek güvenlidir: form alanı güncellemeleri ve içerik akışı değişikleri birbirine karışmaz.

Şablona Dayalı İş Akışlarında Metin Nasıl Güncellenir?

Yaygın bir desen, {{CUSTOMER_NAME}} veya [INVOICE_DATE] gibi yer tutucu simgeler içeren bir PDF şablonunu sürdürmek ve bunları çalışma zamanında gerçek değerlerle değiştirmektir. Her yer tutucu için replaceText bir kez çağırın, böylece PageSelection.allPages() değişimi sembolün göründüğü her yeri kapsar. HTML'den üretilen belgeler için, bu iş akışı serisi bir dizi değiştirme çağrısı ardından renderHtmlAsPdf ile eşit derecede iyi çalışır. Final çıktıya marka veya gizlilik işaretleri eklemek için PDF filigranları veya arka planlar ve ön planlar ile birleştirin.