API de façades

Façades API

L’API Facades fournit des wrappers simplifiés, orientés tâche, autour du modèle d’objet core Aspose.PDF FOSS for .NET. Chaque classe de façade cible une opération PDF spécifique — remplissage de formulaire, concaténation de fichiers, édition de contenu ou signature numérique — et expose un flux de travail BindPdf / Save.

Remplissage de formulaire avec la façade Form

Form (in Aspose.Pdf.Facades) se lie à un PDF existant et vous permet de lire ou d’écrire les valeurs des champs AcroForm sans parcourir l’arborescence des pages.

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

Pour lire les valeurs des champs :

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

Fusion et division de PDF avec PdfFileEditor

PdfFileEditor concatène, divise, extrait et supprime des plages de pages.

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

Modification du contenu de la page avec PdfContentEditor

PdfContentEditor modifie le contenu existant de la page — ajoute du texte, remplace du texte ou attache des actions aux annotations.

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

Signatures numériques avec PdfFileSignature

PdfFileSignature signe des documents PDF et vérifie les signatures existantes.

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

Tamponnage de page avec PdfFileStamp

PdfFileStamp superpose du texte, des images ou d’autres pages PDF en tant que tampons.

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

Conversion de pages en images avec PdfConverter

PdfConverter rend les pages PDF aux formats d’image raster.

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

Conseils et meilleures pratiques

• Appelez toujours Close() ou utilisez using pour libérer les ressources détenues par les objets façade.
• Utilisez BindPdf avec un chemin de fichier pour les gros fichiers afin d’éviter de charger tout en mémoire d’un coup.
• Privilégiez TryConcatenate et TryAppend plutôt que leurs homologues non‑Try pour une gestion d’erreurs élégante.
• Les façades délèguent au modèle central Document en interne — passez à l’API centrale lorsque vous avez besoin d’un contrôle granulaire.
• La façade FormEditor permet d’ajouter de nouveaux champs de formulaire à un PDF existant, pas seulement de remplir ceux déjà présents.

Problèmes courants

FAQ

Quelle est la différence entre les Façades et l’API Document de base ?

Les façades offrent des méthodes de haut niveau, orientées tâches (remplir un formulaire, fusionner des fichiers).
L’API principale (Document, Page, Annotation) donne un accès de bas niveau à
chaque objet PDF. Les façades utilisent l’API principale en interne.

Puis-je chaîner plusieurs opérations de façade ?

Oui. Liez la même source, effectuez les opérations et enregistrez une fois. Ou enregistrez un résultat intermédiaire et reliez‑le pour l’opération suivante.

PdfFileEditor prend‑il en charge les PDF protégés par mot de passe ?

Oui. Des surcharges qui acceptent les mots de passe propriétaire/utilisateur sont disponibles pour les fichiers chiffrés.

Résumé de la référence API

Voir aussi

• Aspose.PDF pour .NET Produit Enterprise