Fasade API

Fasade API

Facades API pruža pojednostavljene, zadatkom usmjerene omotnice oko jezgre Aspose.PDF FOSS for .NET objektnog modela. Svaka klasa fasade cilja određenu PDF operaciju — popunjavanje obrasca, spajanje datoteka, uređivanje sadržaja ili digitalno potpisivanje — i izlaže BindPdf / Save radni tok.


Popunjavanje obrasca s fasadom Form

Form (u Aspose.Pdf.Facades) veže se uz postojeći PDF i omogućuje čitanje ili pisanje vrijednosti polja AcroForm bez navigacije kroz stablo stranica.

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

Za čitanje vrijednosti polja:

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

Spajanje i razdvajanje PDF-ova s PdfFileEditor-om

PdfFileEditor spaja, dijeli, izvlači i briše raspon stranica.

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

Uređivanje sadržaja stranice s PdfContentEditor

PdfContentEditor modificira postojeći sadržaj stranice — dodaje tekst, zamjenjuje tekst ili dodaje radnje na bilješke.

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

Digitalni potpisi s PdfFileSignature

PdfFileSignature potpisuje PDF dokumente i provjerava postojeće potpise.

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

Pečatiranje stranice s PdfFileStamp

PdfFileStamp prekriva tekst, slike ili druge PDF stranice kao žigove.

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

Pretvaranje stranica u slike pomoću PdfConverter

PdfConverter renderira PDF stranice u raster formate slika.

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

Savjeti i najbolje prakse

  • Uvijek pozovite Close() ili upotrijebite using za oslobađanje resursa koje drže objekti fasade.
  • Koristite BindPdf s putanjom do datoteke za velike datoteke kako biste izbjegli učitavanje svega u memoriju odjednom.
  • Preferirajte TryConcatenate i TryAppend umjesto njihovih ne‑Try verzija za elegantno rukovanje pogreškama.
  • Fasade interno delegiraju na jezgru Document model — prebacite se na jezgru API kada trebate finu kontrolu.
  • Fasada FormEditor omogućuje dodavanje novih polja obrasca u postojeći PDF, a ne samo popunjavanje postojećih.

Uobičajeni problemi

ProblemUzrokRješenje
Save() proizvodi praznu datotekuBindPdf nije pozvan prije spremanjaUvijek povežite izvorni PDF prije pozivanja Save
Vrijednost polja obrasca nije zapisanaNaziv polja ne odgovara internom nazivu polja u PDF-uKoristite Form.FieldNames za popis dostupnih naziva polja
Spajanje ne uspijeva tihoUlazna datoteka je šifrirana ili oštećenaKoristite TryConcatenate i provjerite povratnu vrijednost
Potpisi nevažeći nakon uređivanjaSadržaj je modificiran nakon potpisivanjaPotpišite dokument kao posljednji korak

FAQ

Koja je razlika između Facades i osnovnog Document API-ja?

Sučelja pružaju visokorazinske, zadatkom usmjerene metode (popunjavanje obrasca, spajanje datoteka).
Jezgra API (Document, Page, Annotation) pruža pristup nižoj razini
svakom PDF objektu. Sučelja interno koriste jezgru API.

Mogu li lančati više facade operacija?

Da. Povežite isti izvor, izvršite operacije i spremite jednom. Ili spremite međurezultat i ponovno povežite za sljedeću operaciju.

Podržava li PdfFileEditor PDF-ove zaštićene lozinkom?

Da. Preopterećenja koja prihvaćaju lozinke vlasnika/korisnika dostupna su za šifrirane datoteke.


Sažetak referencije API

Class / MethodDescription
FormAcroForm fasada za čitanje i pisanje vrijednosti polja
Form.FillFieldPostavi vrijednost polja obrasca po imenu
Form.GetFieldPročitaj vrijednost polja obrasca po imenu
FormEditorDodaj ili izmijeni polja obrasca u postojećem PDF-u
PdfFileEditorSpajanje, razdvajanje, izdvajanje i brisanje raspona stranica PDF-a
PdfFileEditor.ConcatenateSpoji dva ili više PDF-ova u jedan
PdfFileEditor.ExtractIzdvoji raspon stranica u novi PDF
PdfContentEditorIzmijeni sadržaj stranice (tekst, bilješke, radnje)
PdfFileSignaturePotpiši i provjeri digitalne potpise PDF-a
PdfFileStampPreklopi tekst ili slikovne žigove na stranice
PdfConverterRenderiraj PDF stranice u raster slike
FormattedTextOpis stiliziranog teksta za operacije žiga
FontStyleEnumeracija stilova fonta (podebljano, kurziv, itd.)
EncodingTypeEnumeracija kodiranja znakova

Vidi također

 Hrvatski