Fasādes API

Fasāžu API

Facades API nodrošina vienkāršotus, uz uzdevumu orientētus apvalkus ap galveno Aspose.PDF FOSS for .NET objektu modeli. Katrs fasādes klase mērķē konkrētu PDF operāciju — veidlapu aizpildīšanu, failu savienošanu, satura rediģēšanu vai digitālo parakstīšanu — un atklāj BindPdf / Save darbplūsmu.


Formu aizpildīšana ar Form fasādi

Form (iekš Aspose.Pdf.Facades) piesaista esošu PDF un ļauj lasīt vai rakstīt AcroForm lauku vērtības, nepārvietojoties pa lapas koku.

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

Lai nolasītu lauka vērtības:

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

PDF apvienošana un sadalīšana ar PdfFileEditor

PdfFileEditor apvieno, sadala, izvelk un dzēš lapu diapazonus.

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

Lapas satura rediģēšana ar PdfContentEditor

PdfContentEditor modificē esošo lapas saturu — pievieno tekstu, aizstāj tekstu vai pievieno darbības pie anotācijām.

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

Digitālās paraksti ar PdfFileSignature

PdfFileSignature paraksta PDF dokumentus un pārbauda esošos parakstus.

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

Lapas zīmogu pievienošana ar PdfFileStamp

PdfFileStamp pārklāj tekstu, attēlus vai citas PDF lapas kā zīmolus.

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

Lapu konvertēšana attēlos ar PdfConverter

PdfConverter renderē PDF lapas uz rastra attēlu formātiem.

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

Padomi un labākās prakses

  • Vienmēr izsauciet Close() vai izmantojiet using, lai atbrīvotu resursus, ko tur facādes objekti.
  • Izmantojiet BindPdf ar faila ceļu lieliem failiem, lai izvairītos no visu ielādēšanas atmiņā vienlaicīgi.
  • Dodiet priekšroku TryConcatenate un TryAppend salīdzinājumā ar to ne‑Try ekvivalentiem, lai nodrošinātu elegantu kļūdu apstrādi.
  • Facādes iekšēji delegē uz kodola Document modeli — pārslēdzieties uz kodola API, ja nepieciešama smalkāka vadība.
  • FormEditor facāde ļauj pievienot jaunus veidlapas laukus esošam PDF, ne tikai aizpildīt esošos.

Bieži sastopamās problēmas

ProblēmaIemeslsRisinājums
Save() izveido tukšu failuBindPdf netika izsaukts pirms saglabāšanasVienmēr piesaistiet avota PDF pirms izsaukt Save
Formas lauka vērtība nav ierakstītaLauka nosaukums neatbilst PDF iekšējam lauka nosaukumamIzmantojiet Form.FieldNames, lai uzskaitītu pieejamos lauku nosaukumus
Apvienošana neizdodas klusiIevades fails ir šifrēts vai bojātsIzmantojiet TryConcatenate un pārbaudiet atgriezto vērtību
Paraksti nav derīgi pēc rediģēšanasSaturs tika modificēts pēc parakstīšanasParakstiet dokumentu kā pēdējo soli

Biežāk uzdotie jautājumi

Kāda ir atšķirība starp Facades un kodola Document API?

Facades nodrošina augsta līmeņa, uz uzdevumu orientētas metodes (aizpildīt veidlapu, apvienot failus).
Kodola API (Document, Page, Annotation) nodrošina zemāka līmeņa piekļuvi
katram PDF objektam. Facades iekšēji izmanto kodola API.

Vai es varu ķēdēt vairākas fasādes operācijas?

Jā. Piesaistiet to pašu avotu, veiciet operācijas un saglabājiet vienreiz. Vai arī saglabājiet starpposma rezultātu un atkārtoti piesaistiet nākamajai operācijai.

Vai PdfFileEditor atbalsta ar paroli aizsargātus PDF?

Jā. Pārlādējumi, kas pieņem īpašnieka/lietotāja paroles, ir pieejami šifrētiem failiem.


API atsauces kopsavilkums

Class / MethodDescription
FormAcroForm saskarne lauku vērtību lasīšanai un rakstīšanai
Form.FillFieldIestatīt veidlapas lauka vērtību pēc nosaukuma
Form.GetFieldNolasīt veidlapas lauka vērtību pēc nosaukuma
FormEditorPievienot vai modificēt veidlapas laukus esošā PDF
PdfFileEditorApvienot, sadalīt, izvilkt un dzēst PDF lapu diapazonus
PdfFileEditor.ConcatenateApvienot divus vai vairākus PDF vienā
PdfFileEditor.ExtractIzvilkt lapu diapazonu uz jaunu PDF
PdfContentEditorModificēt lapas saturu (tekstu, anotācijas, darbības)
PdfFileSignatureParakstīt un pārbaudīt PDF digitālos parakstus
PdfFileStampPārklāt tekstu vai attēlu zīmogus uz lapām
PdfConverterRenderēt PDF lapas uz rastra attēliem
FormattedTextStilizēta teksta aprakstītājs zīmogu operācijām
FontStyleFontu stilu uzskaitījums (treknraksts, slīpraksts utt.)
EncodingTypeRakstzīmju kodējuma uzskaitījums

Skatīt arī

 Latviešu