PDF'deki Metni Değiştirme

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

Aşağıdaki örnekte, HTML'den üç sayfalık bir PDF oluşturulmuştur. Değiştirme, 0 ve 2 sayfalarında (birinci ve üçüncü sayfalar) gerçekleştirilir. 1 sayfası (ikinci sayfa) orijinal metni değiştirmeden korur. Sayfa dizinleri, Java'nın sıfır tabanlı dizi kurallarıyla tutarlı olarak her zaman 0 ile başlar.

```java :title=Belirli Birden Fazla Sayfadaki Metni Değiştir //: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 lisans anahtarını ayarla
    License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

    // CSS sayfa sonlarını kullanarak HTML'den 3 sayfalık bir PDF oluşturun
    String html = &quot;<p> .NET6 </p>&quot; +
                  &quot;<p> Bu 1. Sayfadır </p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> Bu 2. sayfadır</p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> .NET6 </p>&quot; +
                  &quot;<p> Bu 3. sayfadır</p>&quot;;

    PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

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

    // Sayfalar sıfırdan numaralandırılmıştır: 0 = ilk sayfa, 2 = üçüncü sayfa
    // Sayfa dizini 1 (ikinci sayfa) kasıtlı olarak hariç tutulmuştur
    Liste<integer> sayfaları = Arrays.asList(0, 2);</integer>

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

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

}

Lütfen dikkate alınIronPDF'deki tüm sayfa indeksleri sıfır tabanlı indekslemeyi takip eder. `0` sayfası ilk sayfadır, `1` sayfası ikinci sayfadır ve bu şekilde devam eder.

HTML'den çok sayfalı PDF'ler oluştururken, sayfa sınırlarının nereye düşeceğini kontrol etmek için [CSS `page-break-after` ](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after)özelliğini kullanın. Render işlemi öncesinde doğru [özel kağıt boyutunu](https://ironpdf.com/java/examples/custom-pdf-paper-size/) ve [sayfa yönünü](https://ironpdf.com/java/examples/pdf-page-orientation/) ayarlamak, metin değiştirme işlemi sırasında içerik konumlarının beklentilerinize uygun olmasını sağlar. Kaydettikten sonra, PDF'yi açarak çıktıyı kontrol edin ve yalnızca hedeflenen sayfaların değiştiğini doğrulayın.

### Çıktı Nasıl Görünür?

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

<hr>

## Hangi Sayfa Seçim Seçenekleri Mevcuttur?

`PageSelection` sınıfı, tüm yaygın hedefleme kalıplarını kapsayan statik fabrika yöntemleri sağlar. Örnek oluşturmaya gerek yoktur; yöntemleri doğrudan sınıf üzerinde çağırın. Tüm indeksler sıfır tabanlıdır.

### Hangi Yöntemler Tek Sayfayı, Hangileri Birden Fazla Sayfayı Hedefler?

<table class="content__data-table" data-content-table>
<caption>replaceText API'si için PageSelection fabrika yöntemleri</caption>

| Yöntem | Açıklama |
|---|---|
| `PageSelection.allPages()` | Belgedeki her sayfayı seçer |
| `PageSelection.firstPage()` | Dizin `0` sayfasında seçilir |
| `PageSelection.lastPage()` | Belge uzunluğuna bakılmaksızın son sayfayı seçer |
| `PageSelection.singlePage(int pageIndex)` | Sıfır tabanlı indeksle belirli bir sayfayı seçer |
| `PageSelection.pageRange(int startIndex, int endIndex)` | `startIndex` ile `endIndex` arasında (bu iki değer dahil) bitişik bir aralık seçer |
| `PageSelection.pageRange(List<Integer> pageList)` | İstenilen herhangi bir dizin kümesinden sayfaları seçer (ör. `[0, 2]`, 1. ve 3. sayfaları seçer) |

</table>

### Her bir PageSelection yöntemini ne zaman kullanmalıyım?

`allPages()`, genel bir bul ve değiştir işlemi için en basit seçenektir: belge genelindeki hedef metnin her örneği tek bir çağrıda değiştirilir. Metin gövdesine dokunmadan kapak sayfalarını veya son sayfa altbilgilerini hızlıca düzenlemek için `firstPage()` veya `lastPage()` kullanın. Metin, bir bölüm veya alt bölüm gibi ardışık bir sayfa dizisinde yer alıyorsa `pageRange(int, int)` seçeneğini seçin. Hedef sayfalar birbirine bitişik değilse `pageRange(List<Integer>)` kullanın; Örneğin, yalnızca 1, 3 ve 7. sayfalarda görünen bir sürüm dizesini değiştirirken.

[Birleştirilmiş PDF'ler](https://ironpdf.com/java/examples/split-pdfs/) veya [yer imleri ve anahatlar](https://ironpdf.com/java/how-to/bookmarks/) içeren belgelerle çalışırken, önce her bir mantıksal bölümün sayfa aralığını belirleyin, ardından ortak üstbilgileri veya altbilgileri yanlışlıkla değiştirmemek için hedefli değiştirmeler uygulayın. [IronPDF for Java API referansı,](https://ironpdf.com/object-reference/api/) tüm `PageSelection` aşırı yüklemelerini tam parametre belgeleriyle birlikte listeler.

Önemli`replaceText` çağrılarını bir try-catch bloğuna sarın. Belirtilen arama metni hedef sayfalardan hiçbirinde bulunmadığında, yöntem bir çalışma zamanı istisnası oluşturur. Bir doğrulama adımı (metni ayıklama ve dizenin mevcut olduğunu onaylama), üretimde beklenmedik hataları önler.

### Tüm Sayfalardaki Metni Tek Seferde Nasıl Değiştirebilirim?

`PageSelection.allPages()`, tek bir çağrı ile belge genelinde bir değiştirme işlemi gerçekleştirir; bu, global token değiştirme için en verimli yaklaşımdır. Aşağıdaki örnekte, diskten bir PDF dosyası yüklenir ve belge genelinde yer tutucu belirtecinin geçtiği her yer değiştirilir:

```java :title=Tüm Sayfalardaki Metni Değiştir
//: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 lisans anahtarını ayarla
        License.setLicenseKey(&quot;IronPDF-MYLICENSE-KEY-1EF01&quot;);

        // Diskten mevcut bir PDF dosyasını yükle
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(&quot;contract-template.pdf&quot;));

        // Her sayfadaki yer tutucu simgesini aynı anda değiştirin
        // Bu, her sayfa için ayrı ayrı replaceText işlevini çağırmaya eşdeğerdir
        pdf.replaceText(PageSelection.allPages(), &quot;{{VERSION}}&quot;, &quot;2.0&quot;);

        // Güncellenen belgeyi kaydedin
        pdf.saveAs(&quot;contract-v2.pdf&quot;);
    }
}

Bu kalıp, aynı yer tutucunun birçok sayfada başlıklarda, altbilgilerde veya gövde metninde göründüğü şablon odaklı iş akışlarıyla doğal bir şekilde eşleşir. Tek sayfalık belgelerde, allPages() ve firstPage() aynı sonuçları verir. Çalışma zamanında sayfa sayısı değişebilecekse allPages() kullanılması tercih edilir.

Büyük/küçük harf duyarlı eşleştirme sonuçları nasıl etkiler?

replaceText, büyük/küçük harf duyarlı tam eşleştirme yapar. "Version 1.0", "version 1.0" ve "VERSION 1.0" dizeleri üç ayrı değer olarak ele alınır. Diskten yüklenen bir belgede değiştirme işlemi yapmadan önce, orijinal kaynağı gözden geçirerek veya PDF'den metni ayıklayıp programlı olarak inceleyerek büyük/küçük harf kullanımını doğrulayın.

PDF Formlarındaki Metni Nasıl Değiştirebilirim?

Etkileşimli form alanları içeren PDF'ler, PDF spesifikasyonunda tanımlandığı gibi metin değerlerini belgenin içerik akışından ayrı olarak depolar. replaceText yöntemi içerik akışında çalışır ve form alanı değerlerini değiştirmez. Form alanlarındaki metni güncellemek için, bunun yerine IronPDF'nin özel form oluşturma ve düzenleme API'sini kullanın. Aynı belgede her iki yaklaşımı bir arada kullanmak güvenlidir: form alanı güncellemeleri ve içerik akışı değiştirmeleri birbirini etkilemez.

Şablon Tabanlı İş Akışlarındaki Metni Nasıl Güncellerim?

Yaygın bir yöntem, yer tutucu belirteçleri (örneğin {{CUSTOMER_NAME}} veya [INVOICE_DATE]) içeren bir PDF şablonu hazırlamak ve bunları çalışma zamanında gerçek değerlerle değiştirmektir. Her yer tutucuya bir kez replaceText çağrısı yapın ve PageSelection.allPages() kullanarak, değiştirme işleminin belirtecin göründüğü her yeri kapsamasını sağlayın. HTML'den oluşturulan belgeler için bu iş akışı, renderHtmlAsPdf ve ardından bir dizi değiştirme çağrısı ile de aynı şekilde iyi sonuç verir. Bunu PDF filigranı veya arka plan ve ön planlarla birleştirerek, nihai çıktıya marka veya gizlilik işaretleri ekleyin.