Fasade API

Facades API

Facades API pruža pojednostavljene, zadatkom orijentisane omotače oko osnovnog Aspose.PDF FOSS for .NET objektnog modela. Svaka facade klasa cilja određenu PDF operaciju — popunjavanje obrazaca, spajanje fajlova, uređivanje sadržaja ili digitalno potpisivanje — i izlaže BindPdf / Save radni tok.

Popunjavanje obrasca pomoću Form fasade

Form (у Aspose.Pdf.Facades) се везује за постојећи PDF и омогућава вам читање или писање вредности AcroForm поља без навигације кроз стабло страница.

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

Za čitanje vrednosti polja:

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

Spajanje i razdvajanje PDF‑ova pomoću PdfFileEditor

PdfFileEditor spaja, deli, izvlači i briše opsege 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 pomoću PdfContentEditor

PdfContentEditor модификује постојећи садржај странице — додаје текст, замењује текст или прикаче акције на анотације.

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

Digitalni potpisi sa PdfFileSignature

PdfFileSignature potpisuje PDF dokumente i proverava postojeće potpise.

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

Pečatiranje stranice pomoću PdfFileStamp

PdfFileStamp preklapa tekst, slike ili druge PDF stranice kao pečate.

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

Pretvaranje stranica u slike pomoću PdfConverter

PdfConverter renderuje PDF stranice u raster formate slika.

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

Saveti i najbolje prakse

• Uvek pozovite Close() ili koristite using da oslobodite resurse koje drže objekti fasade.
• Koristite BindPdf sa putanjom do fajla za velike fajlove kako biste izbegli učitavanje svega u memoriju odjednom.
• Preferirajte TryConcatenate i TryAppend u odnosu na njihove ne‑Try verzije za elegantno rukovanje greškama.
• Fasade interno delegiraju na osnovni model Document — prebacite se na osnovni API kada vam je potrebna detaljna kontrola.
• Fasada FormEditor omogućava dodavanje novih polja obrasca u postojeći PDF, a ne samo popunjavanje postojećih.

Česti problemi

ČPP

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

Facades pružaju visok nivo, zadatkom orijentisane metode (popunjavanje obrasca, spajanje fajlova). Core API (Document, Page, Annotation) daje pristup nižeg nivoa svakom PDF objektu. Facades koriste core API interno.

Могу ли да надовежем више фасадних операција?

Da. Povežite isti izvor, izvršite operacije i sačuvajte jednom. Ili sačuvajte prijelazni rezultat i ponovo povežite za sljedeću operaciju.

Da li PdfFileEditor podržava PDF‑ove zaštićene lozinkom?

Da. Preopterećenja koja prihvataju lozinke vlasnika/korisnika su dostupna za šifrovane fajlove.

Sažetak API referencije

Види такође

• Aspose.PDF for .NET Enterprise Product