عیبیابی
مشکلات رایج و راهحلها هنگام کار با Aspose.PDF FOSS برای .NET.
بارگذاری سند
| Problem | Cause | Solution |
|---|
Document.Open در یک PDF معتبر خطا میاندازد | فایل با رمز محافظت شده است | رمز عبور را در سازنده فراهم کنید |
| کمبود حافظه در PDFهای بزرگ | کل فایل به صورت آرایه بایت بارگذاری میشود | صفحات را بهصورت جداگانه پردازش کنید یا از استریمینگ استفاده کنید |
Pages[0] خطای ایندکس میاندازد | صفحات از ایندکسگذاری ۱-پایه استفاده میکنند | از Pages[1] برای صفحه اول استفاده کنید |
حاشیهنویسیها
| Problem | Cause | Solution |
|---|
| حاشیهنویسی پس از ذخیره نمایش داده نمیشود | مستطیل مساحت صفر دارد یا خارج از مرزهای صفحه است | اطمینان حاصل کنید مختصات درون صفحه قرار دارند MediaBox |
LinkAnnotation.Uri مقدار null برمیگرداند | پیوند از عمل GoTo یا JavaScript استفاده میکند | از طریق PdfAction.Create حل کنید و ActionType را بررسی کنید |
Flatten() استثنا میاندازد | حاشیهنویسی مرجع /P (صفحه) را ندارد | اطمینان حاصل کنید حاشیهنویسی از طریق Page.Annotations اضافه شده است |
استخراج متن
| مشکل | دلیل | راهحل |
|---|
| متن استخراجشده خراب است | رمزگذاری غیر استاندارد یا نگاشت فونت CID | جاسازی فونت را بررسی کنید؛ PDFهای اسکنشده ممکن است به OCR نیاز داشته باشند |
| هیچ بخش متنی یافت نشد | محتوای صفحه یک تصویر رستری است | قبل از استخراج متن از OCR استفاده کنید |
| Regex هیچ مطابقتی برنمیگرداند | چیدمان متن PDF فضاهای خالی وارد میکند | از الگوی سستتر استفاده کنید یا فضاهای خالی را نرمال کنید |
رندرینگ و تبدیل
| مشکل | دلیل | راهحل |
|---|
| تصویر رندر شده تار است | وضوح تصویر خیلی پایین است | DPI را در سازنده Resolution افزایش دهید |
| خروجی HTML تصاویر را نشان نمیدهد | مسیرهای تصویر خارجی پیکربندی نشدهاند | از HtmlSaveOptions با تصاویر جاسازیشده استفاده کنید |
| تبدیل PDF/A حاشیهنویسیها را حذف میکند | پروفایل هدف حاشیهنویسیها را مجاز نمیداند | از PDF/A-2 یا PDF/A-3 استفاده کنید |
فیلدهای فرم
| Problem | Cause | Solution |
|---|
| مقدار فیلد خالی است | فیلد ورودی /V ندارد | بررسی کنید field.Value مقدار null نیست |
FillField تأثیری ندارد | نام فیلد مطابقت ندارد | از Form.FieldNames برای فهرست کردن نامهای موجود استفاده کنید |
| ExportToJson خروجی خالی تولید میکند | حاشیهنویسی ویجت بهدرستی تبدیل نشده است | تأیید کنید حاشیهنویسی یک WidgetAnnotation است |
نکات کلی
- همیشه
Document را در using بپیچید تا دستگیرههای فایل آزاد شوند. - از
Document.Open(byte[]) برای جریانهای کاری در حافظه استفاده کنید تا از قفل شدن فایلها جلوگیری شود. - قبل از دسترسی به صفحات بر اساس شاخص،
doc.Pages.Count را بررسی کنید. - پس از تمام تغییرات، سند را یکبار ذخیره کنید تا بهترین عملکرد را داشته باشید.
همچنین ببینید
