Facade API

Facades API

Facades API, temel Aspose.PDF FOSS for .NET nesne modelinin etrafında basitleştirilmiş, görev odaklı sarmalayıcılar sağlar. Her facade sınıfı belirli bir PDF işlemini hedefler — form doldurma, dosya birleştirme, içerik düzenleme veya dijital imzalama — ve bir BindPdf / Save iş akışı sunar.

Form facade’i ile form doldurma

Form (Aspose.Pdf.Facades içinde) mevcut bir PDF’ye bağlanır ve sayfa ağacını dolaşmadan AcroForm alan değerlerini okumanıza veya yazmanıza olanak tanır.

using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();

Alan değerlerini okumak için:

using var form = new Form("input.pdf");
string name = form.GetField("FirstName");

PdfFileEditor ile PDF’leri birleştirme ve bölme

PdfFileEditor sayfa aralıklarını birleştirir, böler, çıkarır ve siler.

var editor = new PdfFileEditor();

// Concatenate two files
editor.Concatenate("file1.pdf", "file2.pdf", "merged.pdf");

// Extract pages 2-5
editor.Extract("source.pdf", 2, 5, "pages2to5.pdf");

// Split at page 3
editor.SplitFromFirst("source.pdf", 3, "first3.pdf");

Sayfa içeriğini PdfContentEditor ile düzenleme

PdfContentEditor mevcut sayfa içeriğini değiştirir — metin ekle, metni değiştir veya ek açıklamalara eylemler ekle.

var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");

PdfFileSignature ile Dijital imzalar

PdfFileSignature PDF belgelerini imzalar ve mevcut imzaları doğrular.

var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");

PdfFileStamp ile sayfa damgalama

PdfFileStamp metin, görüntü veya diğer PDF sayfalarını damga olarak bindirir.

var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();

PdfConverter ile sayfaları görüntülere dönüştürme

PdfConverter PDF sayfalarını raster görüntü formatlarına dönüştürür.

var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save images

İpuçları ve En İyi Uygulamalar

• Facade nesneleri tarafından tutulan kaynakları serbest bırakmak için her zaman Close() çağırın veya using kullanın.
• Büyük dosyalar için her şeyi bir kerede belleğe yüklemekten kaçınmak amacıyla dosya yolu ile BindPdf kullanın.
• Hata yönetimini nazikçe yapmak için non‑Try karşılıkları yerine TryConcatenate ve TryAppend tercih edin.
• Facade’ler dahili olarak temel Document modeline delege eder — ince ayarlı kontrol gerektiğinde temel API’ye geçin.
• FormEditor facade, mevcut bir PDF’ye yeni form alanları eklemeye izin verir, sadece mevcut olanları doldurmakla sınırlı değildir.

Yaygın Sorunlar

SSS

Facade’ler ile temel Document API’si arasındaki fark nedir?

Facade’ler yüksek seviyeli, görev odaklı yöntemler sağlar (bir form doldur, dosyaları birleştir). Çekirdek API (Document, Page, Annotation) daha düşük seviyeli erişim sağlar her PDF nesnesine. Facade’ler içsel olarak çekirdek API’yi kullanır.

Birden fazla facade işlemini zincirleyebilir miyim?

Evet. Aynı kaynağı bağlayın, işlemleri gerçekleştirin ve bir kez kaydedin. Ya da ara bir sonucu kaydet ve bir sonraki işlem için yeniden bağlayın.

PdfFileEditor şifre korumalı PDF’leri destekliyor mu?

Evet. Sahip/kullanıcı şifrelerini kabul eden aşırı yüklemeler şifreli dosyalar için mevcuttur.

API Referans Özeti

Ayrıca Bakınız

• Aspose.PDF for .NET Enterprise Ürün