Πρόσοψεις API

API Προσόψεων

Το Facades API παρέχει απλοποιημένα, προσανατολισμένα σε εργασίες περιτύλιγμα γύρω από το βασικό
Aspose.PDF FOSS for .NET μοντέλο αντικειμένων. Κάθε κλάση προσκηνίου στοχεύει σε συγκεκριμένη
λειτουργία PDF — συμπλήρωση φορμών, συνένωση αρχείων, επεξεργασία περιεχομένου ή ψηφιακή υπογραφή — και εκθέτει μια ροή εργασίας BindPdf / Save.

Συμπλήρωση φόρμας με το Form facade

Form (in 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 σε μορφές raster εικόνας.

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, όχι μόνο τη συμπλήρωση των υπαρχόντων.

Κοινά προβλήματα

Συχνές ερωτήσεις

Ποια είναι η διαφορά μεταξύ των Facades και του core Document API;

Οι Facades παρέχουν μεθόδους υψηλού επιπέδου, προσανατολισμένες σε εργασίες (συμπλήρωση φόρμας, συγχώνευση αρχείων).
Το core API (Document, Page, Annotation) παρέχει πρόσβαση χαμηλότερου επιπέδου σε
κάθε αντικείμενο PDF. Οι Facades χρησιμοποιούν το core API εσωτερικά.

Μπορώ να συνδέσω πολλαπλές λειτουργίες προσκηνίου;

Ναι. Συνδέστε την ίδια πηγή, εκτελέστε τις λειτουργίες και αποθηκεύστε μία φορά. Ή αποθηκεύστε ένα ενδιάμεσο αποτέλεσμα και επανασυνδέστε για την επόμενη λειτουργία.

Το PdfFileEditor υποστηρίζει PDF με προστασία κωδικού πρόσβασης;

Ναι. Υπάρχουν υπερφορτώσεις που δέχονται κωδικούς ιδιοκτήτη/χρήστη για κρυπτογραφημένα αρχεία.

API Περίληψη Αναφοράς

Δείτε επίσης

• Aspose.PDF for .NET Εταιρικό Προϊόν