Fasadų API

Fasados API

Facades API teikia supaprastintus, užduotimis orientuotus apvalkalius aplink pagrindinį Aspose.PDF FOSS for .NET objektų modelį. Kiekviena fasado klasė skirta konkrečiai PDF operacijai – formų užpildymui, failų sujungimui, turinio redagavimui arba skaitmeniniam pasirašymui – ir atskleidžia BindPdf / Save darbo eigą.

Formų užpildymas naudojant Form fasadą

Form (in Aspose.Pdf.Facades) susieja su esamu PDF ir leidžia skaityti arba rašyti AcroForm laukų reikšmes be puslapių medžio naršymo.

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

Norint perskaityti laukų reikšmes:

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

PDF sujungimas ir skaidymas naudojant PdfFileEditor

PdfFileEditor sujungia, skaidžia, išskiria ir ištrina puslapių intervalus.

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

Redaguoti puslapio turinį naudojant PdfContentEditor

PdfContentEditor modifikuoja esamą puslapio turinį — prideda tekstą, pakeičia tekstą arba priskiria veiksmus anotacijoms.

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

Skaitmeniniai parašai su PdfFileSignature

PdfFileSignature pasirašo PDF dokumentus ir patikrina esamus parašus.

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

Puslapio spaudinimas naudojant PdfFileStamp

PdfFileStamp perdengia tekstą, vaizdus arba kitus PDF puslapius kaip antspaudus.

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

Puslapių konvertavimas į vaizdus naudojant PdfConverter

PdfConverter atvaizduoja PDF puslapius į rastrinius vaizdo formatus.

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

Patarimai ir geriausia praktika

• Visada iškvieskite Close() arba naudokite using, kad atlaisvintumėte išteklius, kuriuos laiko fasado objektai.
• Naudokite BindPdf su failo keliu dideliems failams, kad išvengtumėte visko įkėlimo į atmintį vienu metu.
• Teikite pirmenybę TryConcatenate ir TryAppend vietoje jų ne‑Try atitikmenų, kad būtų švelnesnis klaidų tvarkymas.
• Fasadai viduje deleguoja į pagrindinį Document modelį — perjunkite į pagrindinę API, kai reikia smulkios kontrolės.
• FormEditor fasadas leidžia pridėti naujus formos laukus į esamą PDF, o ne tik užpildyti jau esamus.

Dažnos problemos

DUK

Kuo skiriasi Facades ir pagrindinis Document API?

Fasadai suteikia aukšto lygio, užduotims orientuotas metodus (užpildyti formą, sujungti failus). Pagrindinis API (Document, Page, Annotation) suteikia žemesnio lygio prieigą prie kiekvieno PDF objekto. Fasadai viduje naudoja pagrindinį API.

Ar galiu sujungti kelias fasado operacijas?

Taip. Pririškite tą patį šaltinį, atlikite operacijas ir išsaugokite vieną kartą. Arba išsaugokite
tarpinį rezultatą ir vėl pririškite kitai operacijai.

Ar PdfFileEditor palaiko slaptažodžiu apsaugotus PDF dokumentus?

Taip. Perkrauti, priimantys savininko/vartotojo slaptažodžius, yra prieinami užšifruotiems failams.

API nuorodų santrauka

Žr. taip pat

• Aspose.PDF for .NET Enterprise produktas