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 imagesTips en Best Practices
- Roep altijd
Close()aan of gebruikusingom bronnen die door façade‑objecten worden vastgehouden vrij te geven. - Gebruik
BindPdfmet een bestandspad voor grote bestanden om te voorkomen dat alles in één keer in het geheugen wordt geladen. - Geef de voorkeur aan
TryConcatenateenTryAppendboven 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
| Issue | Cause | Fix |
|---|---|---|
Save() maakt een leeg bestand | BindPdf werd niet aangeroepen vóór opslaan | Bind altijd een bron‑PDF voordat je Save aanroept |
| Formulierveldwaarde niet geschreven | Veldnaam komt niet overeen met de interne veldnaam van de PDF | Gebruik Form.FieldNames om beschikbare veldnamen te tonen |
| Samenvoegen mislukt stilzwijgend | Invoergegevensbestand is versleuteld of beschadigd | Gebruik TryConcatenate en controleer de retourwaarde |
| Handtekeningen ongeldig na bewerking | Inhoud werd gewijzigd na ondertekening | Onderteken 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 / Method | Description |
|---|---|
Form | AcroForm-facade voor het lezen en schrijven van veldwaarden |
Form.FillField | Stel een formulier veldwaarde in op naam |
Form.GetField | Lees een formulier veldwaarde op naam |
FormEditor | Voeg formulier velden toe of wijzig ze in een bestaande PDF |
PdfFileEditor | Samenvoegen, splitsen, extraheren en verwijderen van PDF-paginabereiken |
PdfFileEditor.Concatenate | Voeg twee of meer PDF’s samen tot één |
PdfFileEditor.Extract | Exporteer een paginabereik naar een nieuwe PDF |
PdfContentEditor | Wijzig paginainhoud (tekst, annotaties, acties) |
PdfFileSignature | Onderteken en verifieer PDF-digitale handtekeningen |
PdfFileStamp | Leg tekst- of afbeeldingstempels over pagina’s |
PdfConverter | Render PDF-pagina’s naar rasterafbeeldingen |
FormattedText | Gestileerde tekstdescriptor voor stempelbewerkingen |
FontStyle | Enumeratie van lettertype stijlen (vet, cursief, enz.) |
EncodingType | Enumeratie van tekencoderingen |