API Fasad
Facades API
API Facades menyediakan pembungkus yang disederhanakan, berorientasi tugas di sekitar model objek inti Aspose.PDF FOSS untuk .NET. Setiap kelas facade menargetkan operasi PDF tertentu — pengisian formulir, penggabungan file, penyuntingan konten, atau penandatanganan digital — dan mengekspos alur kerja BindPdf / Save.
Pengisian Form dengan Form facade
Form (in Aspose.Pdf.Facades) mengikat ke PDF yang ada dan memungkinkan Anda membaca atau menulis nilai bidang AcroForm tanpa menavigasi pohon halaman.
using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();Untuk membaca nilai bidang:
using var form = new Form("input.pdf");
string name = form.GetField("FirstName");Menggabungkan dan memisahkan PDF dengan PdfFileEditor
PdfFileEditor menggabungkan, memisahkan, mengekstrak, dan menghapus rentang halaman.
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");Mengedit konten halaman dengan PdfContentEditor
PdfContentEditor memodifikasi konten halaman yang ada — menambahkan teks, mengganti teks, atau melampirkan tindakan ke anotasi.
var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");Tanda tangan digital dengan PdfFileSignature
PdfFileSignature menandatangani dokumen PDF dan memverifikasi tanda tangan yang ada.
var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");Pencetakan halaman dengan PdfFileStamp
PdfFileStamp menimpa teks, gambar, atau halaman PDF lainnya sebagai stempel.
var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();Mengonversi halaman menjadi gambar dengan PdfConverter
PdfConverter merender halaman PDF ke format gambar raster.
var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save imagesTips dan Praktik Terbaik
- Selalu panggil
Close()atau gunakanusinguntuk melepaskan sumber daya yang dipegang oleh objek facade. - Gunakan
BindPdfdengan jalur file untuk file besar agar tidak memuat semuanya ke memori sekaligus. - Lebih pilih
TryConcatenatedanTryAppenddaripada versi non‑Try mereka untuk penanganan kesalahan yang elegan. - Facade mendelegasikan ke model inti
Documentsecara internal — beralih ke API inti ketika Anda memerlukan kontrol yang lebih detail. - Facade
FormEditormemungkinkan penambahan bidang formulir baru ke PDF yang ada, bukan hanya mengisi yang sudah ada.
Masalah Umum
| Issue | Cause | Fix |
|---|---|---|
Save() menghasilkan file kosong | BindPdf tidak dipanggil sebelum menyimpan | Selalu kaitkan PDF sumber sebelum memanggil Save |
| Nilai bidang formulir tidak ditulis | Nama bidang tidak cocok dengan nama bidang internal PDF | Gunakan Form.FieldNames untuk menampilkan nama bidang yang tersedia |
| Penggabungan gagal secara diam-diam | Berkas masukan terenkripsi atau rusak | Gunakan TryConcatenate dan periksa nilai kembaliannya |
| Tanda tangan tidak valid setelah penyuntingan | Konten diubah setelah penandatanganan | Tandatangani dokumen sebagai langkah akhir |
FAQ
Apa perbedaan antara Facades dan core Document API?
Facades menyediakan metode tingkat tinggi yang berorientasi tugas (mengisi formulir, menggabungkan file).
core API (Document, Page, Annotation) memberikan akses tingkat rendah ke
setiap objek PDF. Facades menggunakan core API secara internal.
Bisakah saya menggabungkan beberapa operasi facade?
Ya. Ikat sumber yang sama, lakukan operasi, dan simpan sekali. Atau simpan sebuah hasil menengah dan ikat kembali untuk operasi berikutnya.
Apakah PdfFileEditor mendukung PDF yang dilindungi kata sandi?
Ya. Overloads yang menerima kata sandi pemilik/pengguna tersedia untuk file terenkripsi.
Ringkasan Referensi API
| Class / Method | Description |
|---|---|
Form | Fasade AcroForm untuk membaca dan menulis nilai bidang |
Form.FillField | Setel nilai bidang formulir berdasarkan nama |
Form.GetField | Baca nilai bidang formulir berdasarkan nama |
FormEditor | Tambahkan atau ubah bidang formulir dalam PDF yang ada |
PdfFileEditor | Gabungkan, bagi, ekstrak, dan hapus rentang halaman PDF |
PdfFileEditor.Concatenate | Gabungkan dua atau lebih PDF menjadi satu |
PdfFileEditor.Extract | Ekstrak rentang halaman ke PDF baru |
PdfContentEditor | Ubah konten halaman (teks, anotasi, aksi) |
PdfFileSignature | Tandatangani dan verifikasi tanda tangan digital PDF |
PdfFileStamp | Lapisi teks atau cap gambar pada halaman |
PdfConverter | Render halaman PDF menjadi gambar raster |
FormattedText | Deskriptor teks bergaya untuk operasi cap |
FontStyle | Enumerasi gaya font (tebal, miring, dll.) |
EncodingType | Enumerasi pengkodean karakter |