Fasády API

Fasády API

API Facades poskytuje zjednodušené, úkolově orientované obaly kolem jádra Aspose.PDF FOSS for .NET objektového modelu. Každá třída fasády cílí na konkrétní operaci PDF — vyplňování formulářů, spojování souborů, úpravu obsahu nebo digitální podepisování — a vystavuje workflow BindPdf / Save.

Vyplňování formuláře pomocí fasády Form

Form (v Aspose.Pdf.Facades) se váže na existující PDF a umožňuje číst nebo zapisovat hodnoty polí AcroForm bez procházení stromu stránek.

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

Pro načtení hodnot polí:

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

Sloučení a rozdělení PDF pomocí PdfFileEditor

PdfFileEditor spojuje, rozděluje, extrahuje a maže rozsahy stránek.

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 pomocí PdfContentEditor

PdfContentEditor upravuje existující obsah stránky — přidá text, nahradí text nebo připojí akce k anotacím.

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

Digitální podpisy s PdfFileSignature

PdfFileSignature podepisuje PDF dokumenty a ověřuje existující podpisy.

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

Označování stránek pomocí PdfFileStamp

PdfFileStamp překrývá text, obrázky nebo jiné stránky PDF jako razítka.

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

Převod stránek na obrázky pomocí PdfConverter

PdfConverter renderuje stránky PDF do rastrových formátů obrázků.

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

Tipy a osvědčené postupy

• Vždy zavolejte Close() nebo použijte using k uvolnění prostředků držených objekty fasády.
• Použijte BindPdf s cestou k souboru pro velké soubory, abyste se vyhnuli načítání všeho najednou do paměti.
• Upřednostněte TryConcatenate a TryAppend před jejich ne‑Try protějšky pro elegantní zpracování chyb.
• Fasády interně delegují na jádro modelu Document — přepněte na jádro API, když potřebujete jemnozrnnou kontrolu.
• Fasáda FormEditor umožňuje přidávat nové formulářové pole do existujícího PDF, nejen vyplňovat existující.

Časté problémy

Často kladené otázky

Jaký je rozdíl mezi Facades a jádrovým Document API?

Fasády poskytují vysoceúrovňové, úkolově orientované metody (vyplnit formulář, sloučit soubory). Jádrové API (Document, Page, Annotation) poskytuje nižší úroveň přístupu k každému objektu PDF. Fasády používají jádrové API interně.

Mohu řetězit více operací fasády?

Ano. Připojte stejný zdroj, proveďte operace a uložte jednou. Nebo uložte mezivýsledek a znovu připojte pro další operaci.

Podporuje PdfFileEditor PDF soubory chráněné heslem?

Ano. Přetížení, která přijímají hesla vlastníka/uživatele, jsou k dispozici pro šifrované soubory.

Souhrn referenčního API

Viz také

• Aspose.PDF for .NET Enterprise produkt