Pemecahan Masalah
Masalah umum dan solusi saat bekerja dengan Aspose.PDF FOSS untuk .NET.
Memuat Dokumen
| Masalah | Penyebab | Solusi |
|---|
Document.Open melempar pada PDF yang valid | File dilindungi kata sandi | Berikan kata sandi di konstruktor |
| Kehabisan memori pada PDF besar | Seluruh file dimuat ke dalam array byte | Proses halaman secara individual atau gunakan streaming |
Pages[0] melempar kesalahan indeks | Halaman menggunakan indeks berbasis 1 | Gunakan Pages[1] untuk halaman pertama |
Anotasi
| Masalah | Penyebab | Solusi |
|---|
| Anotasi tidak terlihat setelah disimpan | Persegi panjang memiliki area nol atau berada di luar batas halaman | Verifikasi koordinat berada dalam halaman MediaBox |
LinkAnnotation.Uri mengembalikan null | Tautan menggunakan aksi GoTo atau JavaScript | Selesaikan melalui PdfAction.Create dan periksa ActionType |
Flatten() melempar | Anotasi kehilangan referensi /P (halaman) | Pastikan anotasi ditambahkan melalui Page.Annotations |
Ekstraksi Teks
| Masalah | Penyebab | Solusi |
|---|
| Teks yang diekstrak berantakan | Pengkodean non-standar atau pemetaan font CID | Periksa penyematan font; PDF yang dipindai mungkin memerlukan OCR |
| Tidak ada fragmen teks yang ditemukan | Konten halaman berupa gambar raster | Gunakan OCR sebelum ekstraksi teks |
| Regex tidak menghasilkan kecocokan | Tata letak teks PDF menyisipkan spasi | Gunakan pola yang lebih longgar atau normalisasi spasi |
Rendering dan Konversi
| Problem | Cause | Solution |
|---|
| Gambar yang dirender buram | Resolusi terlalu rendah | Tingkatkan DPI di konstruktor Resolution |
| Output HTML tidak menampilkan gambar | Jalur gambar eksternal tidak dikonfigurasi | Gunakan HtmlSaveOptions dengan gambar tersemat |
| Konversi PDF/A menghapus anotasi | Profil target tidak mengizinkan anotasi | Gunakan PDF/A-2 atau PDF/A-3 |
Bidang Formulir
| Masalah | Penyebab | Solusi |
|---|
| Nilai bidang kosong | Bidang tidak memiliki entri /V | Periksa field.Value tidak null |
FillField tidak berpengaruh | Nama bidang tidak cocok | Gunakan Form.FieldNames untuk menampilkan nama yang tersedia |
| ExportToJson menghasilkan output kosong | Anotasi widget tidak dikasting dengan benar | Verifikasi anotasi adalah WidgetAnnotation |
Tips Umum
- Selalu bungkus
Document dalam using untuk melepaskan handle file. - Gunakan
Document.Open(byte[]) untuk alur kerja dalam memori guna menghindari penguncian file. - Periksa
doc.Pages.Count sebelum mengakses halaman berdasarkan indeks. - Simpan dokumen sekali setelah semua modifikasi untuk kinerja terbaik.
Lihat Juga
