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 imagesSavjeti i najbolje prakse
- Uvijek pozovite
Close()ili upotrijebiteusingza oslobađanje resursa koje drže objekti fasade. - Koristite
BindPdfs putanjom do datoteke za velike datoteke kako biste izbjegli učitavanje svega u memoriju odjednom. - Preferirajte
TryConcatenateiTryAppendumjesto njihovih ne‑Try verzija za elegantno rukovanje pogreškama. - Fasade interno delegiraju na jezgru
Documentmodel — prebacite se na jezgru API kada trebate finu kontrolu. - Fasada
FormEditoromogućuje dodavanje novih polja obrasca u postojeći PDF, a ne samo popunjavanje postojećih.
Uobičajeni problemi
| Problem | Uzrok | Rješenje |
|---|---|---|
Save() proizvodi praznu datoteku | BindPdf nije pozvan prije spremanja | Uvijek povežite izvorni PDF prije pozivanja Save |
| Vrijednost polja obrasca nije zapisana | Naziv polja ne odgovara internom nazivu polja u PDF-u | Koristite Form.FieldNames za popis dostupnih naziva polja |
| Spajanje ne uspijeva tiho | Ulazna datoteka je šifrirana ili oštećena | Koristite TryConcatenate i provjerite povratnu vrijednost |
| Potpisi nevažeći nakon uređivanja | Sadržaj je modificiran nakon potpisivanja | Potpiš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 / Method | Description |
|---|---|
Form | AcroForm fasada za čitanje i pisanje vrijednosti polja |
Form.FillField | Postavi vrijednost polja obrasca po imenu |
Form.GetField | Pročitaj vrijednost polja obrasca po imenu |
FormEditor | Dodaj ili izmijeni polja obrasca u postojećem PDF-u |
PdfFileEditor | Spajanje, razdvajanje, izdvajanje i brisanje raspona stranica PDF-a |
PdfFileEditor.Concatenate | Spoji dva ili više PDF-ova u jedan |
PdfFileEditor.Extract | Izdvoji raspon stranica u novi PDF |
PdfContentEditor | Izmijeni sadržaj stranice (tekst, bilješke, radnje) |
PdfFileSignature | Potpiši i provjeri digitalne potpise PDF-a |
PdfFileStamp | Preklopi tekst ili slikovne žigove na stranice |
PdfConverter | Renderiraj PDF stranice u raster slike |
FormattedText | Opis stiliziranog teksta za operacije žiga |
FontStyle | Enumeracija stilova fonta (podebljano, kurziv, itd.) |
EncodingType | Enumeracija kodiranja znakova |