API של חזיתות
API של פאסאדים
Facades API מספק עטיפות מפושטות, ממוקדות משימה, סביב מודל האובייקטים המרכזי של Aspose.PDF FOSS for .NET. כל מחלקת פאסאד ממקדת בפעולה ספציפית של PDF — מילוי טפסים, צירוף קבצים, עריכת תוכן, או חתימה דיגיטלית — ומחשיפה זרימת עבודה BindPdf / Save.
מילוי טופס עם הפאצד Form
Form (בAspose.Pdf.Facades) קשור ל‑PDF קיים ומאפשר לך לקרוא או לכתוב ערכי שדות AcroForm מבלי לנווט בעץ העמודים.
using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();כדי לקרוא ערכי שדה:
using var form = new Form("input.pdf");
string name = form.GetField("FirstName");מיזוג ופיצול קבצי PDF עם PdfFileEditor
PdfFileEditor מחבר, מחלק, מחלץ ומוחק טווחי עמודים.
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");עריכת תוכן דף עם PdfContentEditor
PdfContentEditor משנה תוכן דף קיים — מוסיף טקסט, מחליף טקסט, או מצרף פעולות להערות.
var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");חתימות דיגיטליות עם PdfFileSignature
PdfFileSignature חותם מסמכי PDF ומאמת חתימות קיימות.
var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");הדפסת עמוד עם PdfFileStamp
PdfFileStamp מניח טקסט, תמונות או דפי PDF אחרים כחותמות.
var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();המרת דפים לתמונות עם PdfConverter
PdfConverter ממיר דפי PDF לפורמטים של תמונות רסטריות.
var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save imagesטיפים ושיטות מומלצות
- תמיד קראו
Close()או השתמשו בusingכדי לשחרר משאבים שמוחזקים על ידי אובייקטי פאסאד. - השתמשו ב
BindPdfעם נתיב קובץ לקבצים גדולים כדי למנוע טעינה של הכל בזיכרון בבת אחת. - העדיפו את
TryConcatenateוTryAppendעל פני הגרסאות הלא‑Try שלהם לטיפול שגיאות אלגנטי. - הפאסאדים מעבירים את הפעולה למודל הליבה
Documentפנימית — עברו ל‑API הליבה כאשר אתם זקוקים לבקרת פירוט מדויקת. - הפאסאד
FormEditorמאפשר הוספת שדות טופס חדשים ל‑PDF קיים, ולא רק מילוי של הקיימים.
בעיות נפוצות
| Issue | Cause | Fix |
|---|---|---|
Save() מייצר קובץ ריק | BindPdf לא נקראה לפני השמירה | תמיד יש לקשר קובץ PDF מקור לפני קריאה ל-Save |
| ערך שדה הטופס לא נכתב | שם השדה אינו תואם לשם השדה הפנימי של ה-PDF | השתמש ב-Form.FieldNames כדי לרשום את שמות השדות הזמינים |
| הצמדה נכשלת בשקט | קובץ הקלט מוצפן או פגום | השתמש ב-TryConcatenate ובדוק את ערך ההחזרה |
| חתימות לא תקפות לאחר עריכה | התוכן שונה לאחר החתימה | חתום על המסמך כצעד הסופי |
שאלות נפוצות
מה ההבדל בין Facades ל‑core Document API?
החזיתות מספקות שיטות ברמת גבוהה, ממוקדות משימה (מילוי טופס, מיזוג קבצים).
ה-API הליבה (Document, Page, Annotation) מספק גישה ברמת נמוכה ל
כל אובייקט PDF. ההחזיתות משתמשות ב-API הליבה באופן פנימי.
האם אני יכול לחבר מספר פעולות פאסאד?
כן. קשור את המקור זהה, בצע פעולות ושמור פעם אחת. או שמור תוצאה ביניים וקשר מחדש לפעולה הבאה.
האם PdfFileEditor תומך בקבצי PDF המוגנים בסיסמה?
כן. גרסאות עומס שמקבלות סיסמאות בעלים/משתמש זמינות לקבצים מוצפנים.
סיכום תיעוד API
| Class / Method | Description |
|---|---|
Form | ממשק AcroForm לקריאה וכתיבת ערכי שדות |
Form.FillField | הגדרת ערך שדה בטופס לפי שם |
Form.GetField | קריאת ערך שדה בטופס לפי שם |
FormEditor | הוספה או שינוי של שדות טופס ב‑PDF קיים |
PdfFileEditor | מיזוג, פיצול, חילוץ ומחיקת טווחי עמודים ב‑PDF |
PdfFileEditor.Concatenate | מיזוג שני PDF‑ים או יותר לקובץ אחד |
PdfFileEditor.Extract | חילוץ טווח עמודים ל‑PDF חדש |
PdfContentEditor | שינוי תוכן העמוד (טקסט, הערות, פעולות) |
PdfFileSignature | חתימה ואימות של חתימות דיגיטליות ב‑PDF |
PdfFileStamp | הוספת חותמות טקסט או תמונה על העמודים |
PdfConverter | המרת עמודי PDF לתמונות רסטר |
FormattedText | מתאר טקסט מעוצב לפעולות חותמת |
FontStyle | מנייה של סגנונות גופנים (מודגש, נטוי וכו') |
EncodingType | מנייה של קידוד תווים |