Fassaden API

Fassaden API

Die Facades API bietet vereinfachte, aufgabenorientierte Wrapper um das Kern Aspose.PDF FOSS for .NET Objektmodell. Jede Fassadenklasse richtet sich an eine bestimmte PDF‑Operation — Formularausfüllung, Dateikonkatinierung, Inhaltsbearbeitung oder digitale Signatur — und stellt einen BindPdf / Save‑Workflow bereit.

Formularausfüllung mit der Form-Fassade

Form (in Aspose.Pdf.Facades) bindet an ein bestehendes PDF und ermöglicht das Lesen oder Schreiben von AcroForm‑Feldwerten, ohne den Seitenbaum zu durchlaufen.

using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();

Um Feldwerte zu lesen:

using var form = new Form("input.pdf");
string name = form.GetField("FirstName");

Zusammenführen und Aufteilen von PDFs mit PdfFileEditor

PdfFileEditor verknüpft, teilt, extrahiert und löscht Seitenbereiche.

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");

Seiteninhalt bearbeiten mit PdfContentEditor

PdfContentEditor ändert vorhandenen Seiteninhalt — Text hinzufügen, Text ersetzen oder Aktionen an Anmerkungen anhängen.

var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");

Digitale Signaturen mit PdfFileSignature

PdfFileSignature signiert PDF-Dokumente und überprüft vorhandene Signaturen.

var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");

Seitenstempel mit PdfFileStamp

PdfFileStamp überlagert Text, Bilder oder andere PDF-Seiten als Stempel.

var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();

Seiten in Bilder konvertieren mit PdfConverter

PdfConverter rendert PDF‑Seiten in Rasterbildformate.

var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save images

Tipps und bewährte Verfahren

• Rufen Sie immer Close() auf oder verwenden Sie using, um Ressourcen freizugeben, die von Fassade‑Objekten gehalten werden.
• Verwenden Sie BindPdf mit einem Dateipfad für große Dateien, um zu vermeiden, dass alles gleichzeitig in den Speicher geladen wird.
• Bevorzugen Sie TryConcatenate und TryAppend gegenüber ihren Nicht‑Try‑Gegenstücken für eine elegante Fehlerbehandlung.
• Fassaden delegieren intern an das Kern‑Document‑Modell — wechseln Sie zur Kern‑API, wenn Sie eine feinkörnige Kontrolle benötigen.
• Die FormEditor‑Fassade ermöglicht das Hinzufügen neuer Formularfelder zu einem bestehenden PDF, nicht nur das Ausfüllen vorhandener.

Häufige Probleme

FAQ

Was ist der Unterschied zwischen Facades und dem Kern Document API?

Fassaden bieten hochrangige, aufgabenorientierte Methoden (ein Formular ausfüllen, Dateien zusammenführen).
Die Kern-API (Document, Page, Annotation) gibt Zugriff auf niedrigerer Ebene
auf jedes PDF-Objekt. Fassaden verwenden die Kern-API intern.

Kann ich mehrere Fassade-Operationen verketten?

Ja. Binden Sie dieselbe Quelle, führen Sie Vorgänge aus und speichern Sie einmal. Oder speichern Sie ein Zwischenergebnis und binden es für den nächsten Vorgang erneut.

Unterstützt PdfFileEditor passwortgeschützte PDFs?

Ja. Überladungen, die Eigentümer‑/Benutzerkennwörter akzeptieren, sind für verschlüsselte Dateien verfügbar.

API-Referenzübersicht

Siehe auch

• Aspose.PDF für .NET Enterprise-Produkt