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 images

Tips og beste praksis

  • Kall alltid Close() eller bruk using for å frigjøre ressurser som holdes av fasadeobjekter.
  • Bruk BindPdf med en filsti for store filer for å unngå å laste alt inn i minnet på én gang.
  • Foretrekk TryConcatenate og TryAppend fremfor 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

IssueCauseFix
Save() produserer tom filBindPdf ble ikke kalt før lagringBind alltid en kilde‑PDF før du kaller Save
Formularfeltverdi ble ikke skrevetFeltnavnet samsvarer ikke med PDF‑ens interne feltnavnBruk Form.FieldNames for å liste tilgjengelige feltnavn
Konkatenasjon mislykkes stilleInndatafilen er kryptert eller korruptBruk TryConcatenate og sjekk returverdien
Signaturer er ugyldige etter redigeringInnholdet ble endret etter signeringSigner 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 / MethodDescription
FormAcroForm-fasade for lesing og skriving av feltverdier
Form.FillFieldAngi en skjemafeltverdi etter navn
Form.GetFieldLes en skjemafeltverdi etter navn
FormEditorLegg til eller endre skjemafelter i en eksisterende PDF
PdfFileEditorSlå sammen, del, trekk ut og slett PDF-siders områder
PdfFileEditor.ConcatenateSlå sammen to eller flere PDF-er til én
PdfFileEditor.ExtractTrekk ut et sideområde til en ny PDF
PdfContentEditorEndre sideinnhold (tekst, merknader, handlinger)
PdfFileSignatureSigner og verifiser PDF digitale signaturer
PdfFileStampLegg over tekst- eller bildemerker på sider
PdfConverterGjengi PDF-sider til rasterbilder
FormattedTextStildefinert tekstbeskrivelse for stempeloperasjoner
FontStyleOppramsing av skriftstiler (fet, kursiv osv.)
EncodingTypeOppramsing av tegnkoding

Se også

 Norsk