Fasády API

Facades API

Facades API poskytuje zjednodušené, úlohou orientované obaly okolo jadrového modelu objektov Aspose.PDF FOSS pre .NET. Každá trieda fasády cielená na konkrétnu operáciu PDF — vyplňovanie formulárov, zlučovanie súborov, úpravu obsahu alebo digitálne podpisovanie — a vystavuje pracovný postup BindPdf / Save.

Vyplňovanie formulára s Form fasádou

Form (v Aspose.Pdf.Facades) viaže existujúci PDF a umožňuje čítať alebo zapisovať hodnoty polí AcroForm bez prechádzania stromom strán.

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

Na čítanie hodnôt polí:

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

Zlučovanie a rozdeľovanie PDF pomocou PdfFileEditor

PdfFileEditor spája, rozdeľuje, extrahuje a maže rozsahy stránok.

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

Úprava obsahu stránky pomocou PdfContentEditor

PdfContentEditor mení existujúci obsah stránky — pridá text, nahradí text alebo pripojí akcie k anotáciám.

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

Digitálne podpisy s PdfFileSignature

PdfFileSignature podpisuje PDF dokumenty a overuje existujúce podpisy.

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

Označovanie stránok pomocou PdfFileStamp

PdfFileStamp prekryje text, obrázky alebo ďalšie PDF stránky ako pečiatky.

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

Konvertovanie stránok na obrázky pomocou PdfConverter

PdfConverter renderuje stránky PDF do rastrových formátov obrázkov.

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

Tipy a najlepšie postupy

• Vždy zavolajte Close() alebo použite using na uvoľnenie zdrojov držených objektmi fasády.
• Použite BindPdf s cestou k súboru pre veľké súbory, aby ste sa vyhli načítaniu všetkého naraz do pamäte.
• Uprednostnite TryConcatenate a TryAppend pred ich ne‑Try ekvivalentmi pre elegantnú manipuláciu s chybami.
• Fasády delegujú na jadrový model Document interne — prejdite na jadrové API, keď potrebujete detailnú kontrolu.
• Fasáda FormEditor umožňuje pridávať nové formulárové polia do existujúceho PDF, nielen vyplňovať existujúce.

Bežné problémy

Často kladené otázky

Aký je rozdiel medzi Facades a jadrovým Document API?

Facades poskytujú metódy vysokou úrovňou, orientované na úlohy (vyplniť formulár, zlúčiť súbory).
core API (Document, Page, Annotation) poskytuje prístup na nižšej úrovni ku každému PDF objektu. Facades používajú core API interne.

Môžem reťaziť viacero operácií fasády?

Áno. Pripojte rovnaký zdroj, vykonajte operácie a uložte raz. Alebo uložte medzivýsledok a znovu pripojte pre ďalšiu operáciu.

Podporuje PdfFileEditor PDF súbory chránené heslom?

Áno. Pre šifrované súbory sú k dispozícii preťaženia, ktoré akceptujú heslá vlastníka/užívateľa.

API Referenčný prehľad

Pozri tiež

• Aspose.PDF pre .NET Enterprise produkt