פתרון בעיות
בעיות נפוצות ופתרונות בעת עבודה עם Aspose.PDF FOSS עבור .NET.
טעינת מסמך
| בעיה | סיבה | פתרון |
|---|
Document.Open נזרק על PDF תקין | הקובץ מוגן בסיסמה | ספק את הסיסמה בבונה |
| חוסר בזיכרון בקבצי PDF גדולים | הקובץ כולו נטען למערך בתים | עבד דפים בנפרד או השתמש בזרימה |
Pages[0] נזרק שגיאת אינדקס | דפים משתמשים באינדקס מבוסס 1 | השתמש ב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 |
שדות טופס
| בעיה | סיבה | פתרון |
|---|
| ערך השדה ריק | לשדה אין ערך /V | ודא שfield.Value אינו null |
FillField אינו משפיע | חוסר התאמה בשם השדה | השתמש בForm.FieldNames כדי לרשום שמות זמינים |
| ExportToJson מייצר פלט ריק | ההערה של הווידג’ט לא הומרת כראוי | ודא שההערה היא WidgetAnnotation |
טיפים כלליים
- תמיד לעטוף
Document בusing כדי לשחרר ידיות קבצים. - השתמש ב
Document.Open(byte[]) עבור זרימות זיכרון כדי למנוע נעילות קבצים. - בדוק את
doc.Pages.Count לפני גישה לדפים לפי אינדקס. - שמור את המסמך פעם אחת לאחר כל השינויים לקבלת ביצועים מיטביים.
ראה גם