API של חזיתות

API של חזיתות

API של פאסאדים

Facades API מספק עטיפות מפושטות, ממוקדות משימה, סביב מודל האובייקטים המרכזי של Aspose.PDF FOSS for .NET. כל מחלקת פאסאד ממקדת בפעולה ספציפית של PDF — מילוי טפסים, צירוף קבצים, עריכת תוכן, או חתימה דיגיטלית — ומחשיפה זרימת עבודה BindPdf / Save.


מילוי טופס עם הפאצד Form

FormAspose.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 קיים, ולא רק מילוי של הקיימים.

בעיות נפוצות

IssueCauseFix
Save() מייצר קובץ ריקBindPdf לא נקראה לפני השמירהתמיד יש לקשר קובץ PDF מקור לפני קריאה ל-Save
ערך שדה הטופס לא נכתבשם השדה אינו תואם לשם השדה הפנימי של ה-PDFהשתמש ב-Form.FieldNames כדי לרשום את שמות השדות הזמינים
הצמדה נכשלת בשקטקובץ הקלט מוצפן או פגוםהשתמש ב-TryConcatenate ובדוק את ערך ההחזרה
חתימות לא תקפות לאחר עריכההתוכן שונה לאחר החתימהחתום על המסמך כצעד הסופי

שאלות נפוצות

מה ההבדל בין Facades ל‑core Document API?

החזיתות מספקות שיטות ברמת גבוהה, ממוקדות משימה (מילוי טופס, מיזוג קבצים).
ה-API הליבה (Document, Page, Annotation) מספק גישה ברמת נמוכה ל
כל אובייקט PDF. ההחזיתות משתמשות ב-API הליבה באופן פנימי.

האם אני יכול לחבר מספר פעולות פאסאד?

כן. קשור את המקור זהה, בצע פעולות ושמור פעם אחת. או שמור תוצאה ביניים וקשר מחדש לפעולה הבאה.

האם PdfFileEditor תומך בקבצי PDF המוגנים בסיסמה?

כן. גרסאות עומס שמקבלות סיסמאות בעלים/משתמש זמינות לקבצים מוצפנים.


סיכום תיעוד API

Class / MethodDescription
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מנייה של קידוד תווים

ראה גם

 עברית