API de fasades

API de fasades

L’API Facades proporciona envoltorns simplificats i orientats a tasques al voltant del model d’objectes principal d’Aspose.PDF FOSS per a .NET. Cada classe de façana s’enfoca en una operació PDF específica — omplir formularis, concatenació de fitxers, edició de contingut o signatura digital — i exposa un flux de treball BindPdf / Save.

Omplir formularis amb la façana Form

Form (a Aspose.Pdf.Facades) s’uneix a un PDF existent i et permet llegir o escriure valors de camps AcroForm sense navegar per l’arbre de pàgines.

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

Per llegir els valors dels camps:

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

Combinar i dividir PDFs amb PdfFileEditor

PdfFileEditor concatena, divideix, extreu i elimina intervals de pàgines.

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

Edició del contingut de la pàgina amb PdfContentEditor

PdfContentEditor modifica el contingut existent de la pàgina — afegeix text, substitueix text o adjunta accions a les anotacions.

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

Signatures digitals amb PdfFileSignature

PdfFileSignature signa documents PDF i verifica signatures existents.

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

Estampat de pàgina amb PdfFileStamp

PdfFileStamp superposa text, imatges o altres pàgines PDF com a segells.

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

Convertint pàgines a imatges amb PdfConverter

PdfConverter renderitza pàgines PDF a formats d’imatge raster.

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

Consells i bones pràctiques

• Sempre crideu Close() o utilitzeu using per alliberar els recursos que mantenen els objectes de façana.
• Utilitzeu BindPdf amb una ruta de fitxer per a fitxers grans per evitar carregar-ho tot a la memòria alhora.
• Preferiu TryConcatenate i TryAppend en comptes de les seves versions sense Try per a una gestió d’errors més elegant.
• Les façanes deleguen al model central Document internament — canvieu a l’API central quan necessiteu un control més detallat.
• La façana FormEditor permet afegir nous camps de formulari a un PDF existent, no només emplenar els existents.

Problemes comuns

FAQ

Quina és la diferència entre Facades i el nucli del Document API?

Les façanes ofereixen mètodes d’alt nivell i orientats a tasques (omplir un formulari, combinar fitxers).
L’API central (Document, Page, Annotation) proporciona accés de nivell inferior a
cada objecte PDF. Les façanes utilitzen l’API central internament.

Puc encadenar múltiples operacions de façana?

Sí. Enllaça la mateixa font, realitza operacions i desa una sola vegada. O desa un resultat intermedi i torna a enllaçar per a l’operació següent.

PdfFileEditor admet PDFs protegits amb contrasenya?

Sí. Les sobrecàrregues que accepten contrasenyes de propietari/usuari estan disponibles per a fitxers encriptats.

Resum de la referència de l’API

Vegeu també

• Aspose.PDF for .NET Enterprise Product