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 images

Tips dan Praktik Terbaik

  • Selalu panggil Close() atau gunakan using untuk melepaskan sumber daya yang dipegang oleh objek facade.
  • Gunakan BindPdf dengan jalur file untuk file besar agar tidak memuat semuanya ke memori sekaligus.
  • Lebih pilih TryConcatenate dan TryAppend daripada versi non‑Try mereka untuk penanganan kesalahan yang elegan.
  • Facade mendelegasikan ke model inti Document secara internal — beralih ke API inti ketika Anda memerlukan kontrol yang lebih detail.
  • Facade FormEditor memungkinkan penambahan bidang formulir baru ke PDF yang ada, bukan hanya mengisi yang sudah ada.

Masalah Umum

IssueCauseFix
Save() menghasilkan file kosongBindPdf tidak dipanggil sebelum menyimpanSelalu kaitkan PDF sumber sebelum memanggil Save
Nilai bidang formulir tidak ditulisNama bidang tidak cocok dengan nama bidang internal PDFGunakan Form.FieldNames untuk menampilkan nama bidang yang tersedia
Penggabungan gagal secara diam-diamBerkas masukan terenkripsi atau rusakGunakan TryConcatenate dan periksa nilai kembaliannya
Tanda tangan tidak valid setelah penyuntinganKonten diubah setelah penandatangananTandatangani 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 / MethodDescription
FormFasade AcroForm untuk membaca dan menulis nilai bidang
Form.FillFieldSetel nilai bidang formulir berdasarkan nama
Form.GetFieldBaca nilai bidang formulir berdasarkan nama
FormEditorTambahkan atau ubah bidang formulir dalam PDF yang ada
PdfFileEditorGabungkan, bagi, ekstrak, dan hapus rentang halaman PDF
PdfFileEditor.ConcatenateGabungkan dua atau lebih PDF menjadi satu
PdfFileEditor.ExtractEkstrak rentang halaman ke PDF baru
PdfContentEditorUbah konten halaman (teks, anotasi, aksi)
PdfFileSignatureTandatangani dan verifikasi tanda tangan digital PDF
PdfFileStampLapisi teks atau cap gambar pada halaman
PdfConverterRender halaman PDF menjadi gambar raster
FormattedTextDeskriptor teks bergaya untuk operasi cap
FontStyleEnumerasi gaya font (tebal, miring, dll.)
EncodingTypeEnumerasi pengkodean karakter

Lihat Juga

 Bahasa Indonesia