Fasader API
Fasader API
Facades API gir forenklede, oppgaveorienterte omslag rundt kjernemodellen Aspose.PDF FOSS for .NET objektmodell. Hver facade-klasse retter seg mot en spesifikk PDF-operasjon — utfylling av skjema, filkonsolidering, innholdsredigering eller digital signering — og eksponerer en BindPdf / Save arbeidsflyt.
Skjemautfylling med Form-fasade
Form (i Aspose.Pdf.Facades) binder seg til en eksisterende PDF og lar deg lese eller skrive AcroForm-feltverdier uten å navigere i sidetre.
using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();For å lese feltverdier:
using var form = new Form("input.pdf");
string name = form.GetField("FirstName");Sammenslåing og deling av PDF-er med PdfFileEditor
PdfFileEditor slår sammen, deler, ekstraherer og sletter sideområder.
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");Redigere sideinnhold med PdfContentEditor
PdfContentEditor endrer eksisterende sideinnhold — legg til tekst, erstatt tekst, eller legg ved handlinger til annotasjoner.
var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");Digitale signaturer med PdfFileSignature
PdfFileSignature signerer PDF-dokumenter og verifiserer eksisterende signaturer.
var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");Sidemerking med PdfFileStamp
PdfFileStamp legger over tekst, bilder eller andre PDF‑sider som stempler.
var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();Konvertere sider til bilder med PdfConverter
PdfConverter gjengir PDF‑sider til raster‑bildeformater.
var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save imagesTips og beste praksis
- Kall alltid
Close()eller brukusingfor å frigjøre ressurser som holdes av fasadeobjekter. - Bruk
BindPdfmed en filsti for store filer for å unngå å laste alt inn i minnet på én gang. - Foretrekk
TryConcatenateogTryAppendfremfor deres ikke‑Try‑motparter for elegant feilbehandling. - Fasader delegere internt til kjernemodellen
Document— bytt til kjerne‑API‑et når du trenger finjustert kontroll. FormEditor‑fasaden gjør det mulig å legge til nye skjemafelter i en eksisterende PDF, ikke bare fylle ut eksisterende.
Vanlige problemer
| Issue | Cause | Fix |
|---|---|---|
Save() produserer tom fil | BindPdf ble ikke kalt før lagring | Bind alltid en kilde‑PDF før du kaller Save |
| Formularfeltverdi ble ikke skrevet | Feltnavnet samsvarer ikke med PDF‑ens interne feltnavn | Bruk Form.FieldNames for å liste tilgjengelige feltnavn |
| Konkatenasjon mislykkes stille | Inndatafilen er kryptert eller korrupt | Bruk TryConcatenate og sjekk returverdien |
| Signaturer er ugyldige etter redigering | Innholdet ble endret etter signering | Signer dokumentet som siste steg |
Ofte stilte spørsmål
Hva er forskjellen mellom Facades og kjerne Document API?
Fasader gir høy‑nivå, oppgaveorienterte metoder (fylle ut et skjema, slå sammen filer).
Kjerne‑API‑et (Document, Page, Annotation) gir lavnivåtilgang til
alle PDF‑objekter. Fasader bruker kjerne‑API‑et internt.
Kan jeg kjede flere facade‑operasjoner?
Ja. Bind den samme kilden, utfør operasjoner, og lagre én gang. Eller lagre et mellomresultat og bind på nytt for neste operasjon.
Støtter PdfFileEditor passordbeskyttede PDF-filer?
Ja. Overlastinger som godtar eier-/brukerpassord er tilgjengelige for krypterte filer.
API-referansesammendrag
| Class / Method | Description |
|---|---|
Form | AcroForm-fasade for lesing og skriving av feltverdier |
Form.FillField | Angi en skjemafeltverdi etter navn |
Form.GetField | Les en skjemafeltverdi etter navn |
FormEditor | Legg til eller endre skjemafelter i en eksisterende PDF |
PdfFileEditor | Slå sammen, del, trekk ut og slett PDF-siders områder |
PdfFileEditor.Concatenate | Slå sammen to eller flere PDF-er til én |
PdfFileEditor.Extract | Trekk ut et sideområde til en ny PDF |
PdfContentEditor | Endre sideinnhold (tekst, merknader, handlinger) |
PdfFileSignature | Signer og verifiser PDF digitale signaturer |
PdfFileStamp | Legg over tekst- eller bildemerker på sider |
PdfConverter | Gjengi PDF-sider til rasterbilder |
FormattedText | Stildefinert tekstbeskrivelse for stempeloperasjoner |
FontStyle | Oppramsing av skriftstiler (fet, kursiv osv.) |
EncodingType | Oppramsing av tegnkoding |