API Fațade

Fațade API

API-ul Facades oferă învelișuri simplificate, orientate pe sarcini, în jurul modelului de obiecte de bază Aspose.PDF FOSS pentru .NET. Fiecare clasă de fațadă vizează o operație PDF specifică — completarea formularelor, concatenarea fișierelor, editarea conținutului sau semnarea digitală — și expune un flux de lucru BindPdf / Save.

Completarea formularului cu fațada Form

Form (în Aspose.Pdf.Facades) se leagă de un PDF existent și vă permite să citiți sau să scrieți valori ale câmpurilor AcroForm fără a naviga prin arborele de pagini.

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

Pentru a citi valorile câmpurilor:

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

Îmbinarea și despărțirea PDF-urilor cu PdfFileEditor

PdfFileEditor concatenează, împarte, extrage și șterge intervale de pagini.

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

Editarea conținutului paginii cu PdfContentEditor

PdfContentEditor modifică conținutul existent al paginii — adaugă text, înlocuiește textul sau atașează acțiuni la adnotări.

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

Semnături digitale cu PdfFileSignature

PdfFileSignature semnează documente PDF și verifică semnăturile existente.

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

Stamparea paginilor cu PdfFileStamp

PdfFileStamp suprapune text, imagini sau alte pagini PDF ca ștampile.

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

Convertirea paginilor în imagini cu PdfConverter

PdfConverter redă paginile PDF în formate de imagini raster.

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

Sfaturi și cele mai bune practici

• Apelați întotdeauna Close() sau utilizați using pentru a elibera resursele deținute de obiectele facade.
• Utilizați BindPdf cu o cale de fișier pentru fișiere mari pentru a evita încărcarea întregului în memorie simultan.
• Preferați TryConcatenate și TryAppend în locul omoloagelor lor fără Try pentru o gestionare grațioasă a erorilor.
• Facade-urile delegă intern modelului de bază Document — treceți la API-ul de bază când aveți nevoie de control detaliat.
• Facade-ul FormEditor permite adăugarea de noi câmpuri de formular într-un PDF existent, nu doar completarea celor existente.

Probleme comune

Întrebări frecvente

Care este diferența dintre Facades și nucleul Document API?

Fațadele oferă metode de nivel înalt, orientate pe sarcini (completarea unui formular, îmbinarea fișierelor). API-ul de bază (Document, Page, Annotation) oferă acces la nivel inferior la fiecare obiect PDF. Fațadele utilizează API-ul de bază intern.

Pot să înlănțui mai multe operații de fațadă?

Da. Leagă aceeași sursă, efectuează operațiile și salvează o singură dată. Sau salvează un rezultat intermediar
și leagă din nou pentru următoarea operație.

PdfFileEditor suportă PDF-uri protejate cu parolă?

Da. Suprasarcinile care acceptă parolele proprietar/utilizator sunt disponibile pentru fișiere criptate.

Sumar referință API

Vezi și

• Aspose.PDF pentru .NET Produs Enterprise