Facade API

Facader API

Facade‑API’en giver forenklede, opgaveorienterede wrappers omkring den grundlæggende Aspose.PDF FOSS for .NET objektmodel. Hver facade‑klasse retter sig mod en specifik PDF‑operation — udfyldning af formularer, filkonkatenation, indholdsredigering eller digital signering — og eksponerer en BindPdf / Save arbejdsflow.

Udfyldning af formular med Form-facaden

Form (i Aspose.Pdf.Facades) binder til en eksisterende PDF og lader dig læse eller skrive AcroForm-feltværdier uden at navigere i sidetræet.

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

For at læse felternes værdier:

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

Sammenfletning og opdeling af PDF-filer med PdfFileEditor

PdfFileEditor sammenkæder, splitter, udtrækker og sletter sideintervaller.

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

Redigering af sideindhold med PdfContentEditor

PdfContentEditor ændrer eksisterende sideindhold — tilføj tekst, erstat tekst eller vedhæft handlinger til annotationer.

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

Digitale signaturer med PdfFileSignature

PdfFileSignature underskriver PDF-dokumenter og verificerer eksisterende signaturer.

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

Side-stempling med PdfFileStamp

PdfFileStamp overlejrer tekst, billeder eller andre PDF‑sider som stempler.

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

Konvertering af sider til billeder med PdfConverter

PdfConverter rendererer PDF‑sider til raster‑billedformater.

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

Tips og bedste praksis

• Kald altid Close() eller brug using for at frigøre ressourcer, som facadobjekter holder.
• Brug BindPdf med en filsti for store filer for at undgå at indlæse alt i hukommelsen på én gang.
• Foretræk TryConcatenate og TryAppend frem for deres ikke‑Try-modparter for en elegant fejlhåndtering.
• Facader delegere internt til kerne Document‑modellen — skift til kerne‑API’en, når du har brug for finjusteret kontrol.
• FormEditor‑facaden tillader at tilføje nye formularfelter til en eksisterende PDF, ikke kun at udfylde eksisterende.

Almindelige problemer

Ofte stillede spørgsmål

Hvad er forskellen mellem Facades og den centrale Document API?

Facader leverer højtniveau, opgaveorienterede metoder (udfyld en formular, sammenslå filer). Kerne-API (Document, Page, Annotation) giver adgang på lavere niveau til hver PDF-objekt. Facader bruger kerne-API’en internt.

Kan jeg kæde flere facade‑operationer?

Ja. Bind den samme kilde, udfør operationer, og gem én gang. Eller gem et mellemliggende resultat og bind igen til den næste operation.

Understøtter PdfFileEditor passwordbeskyttede PDF-filer?

Ja. Overloads, der accepterer ejer-/brugeradgangskoder, er tilgængelige for krypterede filer.

API-referencens oversigt

Se også

• Aspose.PDF for .NET Enterprise Product