Gevels API

Facade API

De Facades API biedt vereenvoudigde, taakgerichte wrappers rond het kern Aspose.PDF FOSS for .NET objectmodel. Elke facade‑klasse richt zich op een specifieke PDF‑bewerking — formulier invullen, bestandsconcatenatie, inhoudsbewerking, of digitale ondertekening — en maakt een BindPdf / Save workflow beschikbaar.


Formulier invullen met de Form-facade

Form (in Aspose.Pdf.Facades) bindt aan een bestaande PDF en laat u AcroForm-veldwaarden lezen of schrijven zonder door de paginaboom te navigeren.

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

Om veldwaarden te lezen:

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

Samenvoegen en splitsen van PDF’s met PdfFileEditor

PdfFileEditor voegt samen, splitst, extraheert en verwijdert paginabereiken.

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

Pagina-inhoud bewerken met PdfContentEditor

PdfContentEditor wijzigt bestaande paginainhoud — voeg tekst toe, vervang tekst, of koppel acties aan annotaties.

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

Digitale handtekeningen met PdfFileSignature

PdfFileSignature ondertekent PDF-documenten en verifieert bestaande handtekeningen.

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

Pagina‑stempeling met PdfFileStamp

PdfFileStamp legt tekst, afbeeldingen of andere PDF-pagina’s als stempels over.

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

Paginas converteren naar afbeeldingen met PdfConverter

PdfConverter rendert PDF-pagina’s naar rasterafbeeldingsformaten.

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

Tips en Best Practices

  • Roep altijd Close() aan of gebruik using om bronnen die door façade‑objecten worden vastgehouden vrij te geven.
  • Gebruik BindPdf met een bestandspad voor grote bestanden om te voorkomen dat alles in één keer in het geheugen wordt geladen.
  • Geef de voorkeur aan TryConcatenate en TryAppend boven hun niet‑Try‑tegenhangers voor een elegante foutafhandeling.
  • Facades delegeren intern aan het kernmodel Document — schakel over naar de kern‑API wanneer je fijnmazige controle nodig hebt.
  • De FormEditor‑facade maakt het mogelijk nieuwe formuliervelden toe te voegen aan een bestaande PDF, niet alleen bestaande velden in te vullen.

Veelvoorkomende problemen

IssueCauseFix
Save() maakt een leeg bestandBindPdf werd niet aangeroepen vóór opslaanBind altijd een bron‑PDF voordat je Save aanroept
Formulierveldwaarde niet geschrevenVeldnaam komt niet overeen met de interne veldnaam van de PDFGebruik Form.FieldNames om beschikbare veldnamen te tonen
Samenvoegen mislukt stilzwijgendInvoergegevensbestand is versleuteld of beschadigdGebruik TryConcatenate en controleer de retourwaarde
Handtekeningen ongeldig na bewerkingInhoud werd gewijzigd na ondertekeningOnderteken het document als laatste stap

FAQ

Wat is het verschil tussen Facades en de core Document API?

Facades bieden hoog‑niveau, taakgerichte methoden (een formulier invullen, bestanden samenvoegen).
De core API (Document, Page, Annotation) biedt toegang op een lager niveau tot
elk PDF‑object. Facades gebruiken de core API intern.

Kan ik meerdere facade‑operaties achter elkaar uitvoeren?

Ja. Bind dezelfde bron, voer bewerkingen uit en sla één keer op. Of sla een tussentijds resultaat op en bind opnieuw voor de volgende bewerking.

Ondersteunt PdfFileEditor wachtwoordbeveiligde PDF’s?

Ja. Overloads die eigenaar/gebruiker-wachtwoorden accepteren, zijn beschikbaar voor versleutelde bestanden.


API-referentieoverzicht

Class / MethodDescription
FormAcroForm-facade voor het lezen en schrijven van veldwaarden
Form.FillFieldStel een formulier veldwaarde in op naam
Form.GetFieldLees een formulier veldwaarde op naam
FormEditorVoeg formulier velden toe of wijzig ze in een bestaande PDF
PdfFileEditorSamenvoegen, splitsen, extraheren en verwijderen van PDF-paginabereiken
PdfFileEditor.ConcatenateVoeg twee of meer PDF’s samen tot één
PdfFileEditor.ExtractExporteer een paginabereik naar een nieuwe PDF
PdfContentEditorWijzig paginainhoud (tekst, annotaties, acties)
PdfFileSignatureOnderteken en verifieer PDF-digitale handtekeningen
PdfFileStampLeg tekst- of afbeeldingstempels over pagina’s
PdfConverterRender PDF-pagina’s naar rasterafbeeldingen
FormattedTextGestileerde tekstdescriptor voor stempelbewerkingen
FontStyleEnumeratie van lettertype stijlen (vet, cursief, enz.)
EncodingTypeEnumeratie van tekencoderingen

Zie ook

 Nederlands