Facade-rajapinnat API

Facade-rajapinta

Facades API tarjoaa yksinkertaistettuja, tehtäväkeskeisiä kääreitä ydin Aspose.PDF FOSS for .NET -objektimallin ympärille. Jokainen facade-luokka kohdistuu tiettyyn PDF-toimintoon — lomakkeiden täyttö, tiedostojen yhdistäminen, sisällön muokkaus tai digitaalinen allekirjoitus — ja paljastaa BindPdf / Save -työnkulun.

Lomakkeen täyttäminen Form-fasadilla

Form (kohdassa Aspose.Pdf.Facades) sitoo olemassa olevaan PDF‑tiedostoon ja mahdollistaa AcroForm‑kenttien arvojen lukemisen tai kirjoittamisen ilman sivupuun selaamista.

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

Kenttien arvojen lukeminen:

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

PDF-tiedostojen yhdistäminen ja jakaminen PdfFileEditorilla

PdfFileEditor yhdistää, jakaa, poimii ja poistaa sivualueita.

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

Sivun sisällön muokkaus PdfContentEditorilla

PdfContentEditor muokkaa olemassa olevaa sivun sisältöä — lisää tekstiä, korvaa tekstiä tai liitä toimintoja merkintöihin.

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

Digitaaliset allekirjoitukset PdfFileSignature:n avulla

PdfFileSignature allekirjoittaa PDF-asiakirjoja ja tarkistaa olemassa olevat allekirjoitukset.

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

Sivun leimaus PdfFileStampin avulla

PdfFileStamp päällekirjoittaa tekstiä, kuvia tai muita PDF-sivuja leimoina.

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

Sivujen muuntaminen kuviksi PdfConverterilla

PdfConverter renderöi PDF-sivut rasterikuvamuotoihin.

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

Vinkkejä ja parhaita käytäntöjä

• Kutsu aina Close() tai käytä using vapauttaaksesi facade‑objektien hallussa olevat resurssit.
• Käytä BindPdf tiedostopolun kanssa suurille tiedostoille, jotta vältetään kaiken lataaminen muistiin kerralla.
• Suosi TryConcatenate‑ ja TryAppend‑menetelmiä niiden ei‑Try‑vastineiden sijaan, jotta virheiden käsittely olisi sujuvaa.
• Facade‑objektit delegoivat sisäisesti ydinkomponentin Document‑malliin — siirry ydinkirjasto‑APIin, kun tarvitset tarkkaa hallintaa.
• FormEditor‑facade mahdollistaa uusien lomakekenttien lisäämisen olemassa olevaan PDF:ään, eikä vain olemassa olevien täyttämistä.

Yleiset ongelmat

UKK

Mikä on ero Facades- ja core Document API:n välillä?

Facade-rajapinnat tarjoavat korkean tason, tehtäväkeskeisiä menetelmiä (täytä lomake, yhdistä tiedostoja). Ydin-API (Document, Page, Annotation) antaa alemmantason pääsyn kaikkiin PDF-objekteihin. Facade-rajapinnat käyttävät ydin-API:a sisäisesti.

Voinko ketjuttaa useita facade-toimintoja?

Kyllä. Sidota sama lähde, suorita toiminnot ja tallenna kerran. Tai tallenna
välituloksen ja sidota uudelleen seuraavaa toimintoa varten.

Tukeeko PdfFileEditor salasanasuojattuja PDF-tiedostoja?

Kyllä. Ylikuormitukset, jotka hyväksyvät omistaja/käyttäjä-salasanat, ovat saatavilla salatuille tiedostoille.

API-viitteiden yhteenveto

Katso myös

• Aspose.PDF for .NET Enterprise -tuote