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 imagesPadomi un labākās prakses
- Vienmēr izsauciet
Close()vai izmantojietusing, lai atbrīvotu resursus, ko tur facādes objekti. - Izmantojiet
BindPdfar faila ceļu lieliem failiem, lai izvairītos no visu ielādēšanas atmiņā vienlaicīgi. - Dodiet priekšroku
TryConcatenateunTryAppendsalīdzinājumā ar to ne‑Try ekvivalentiem, lai nodrošinātu elegantu kļūdu apstrādi. - Facādes iekšēji delegē uz kodola
Documentmodeli — pārslēdzieties uz kodola API, ja nepieciešama smalkāka vadība. FormEditorfacāde ļauj pievienot jaunus veidlapas laukus esošam PDF, ne tikai aizpildīt esošos.
Bieži sastopamās problēmas
| Problēma | Iemesls | Risinājums |
|---|---|---|
Save() izveido tukšu failu | BindPdf netika izsaukts pirms saglabāšanas | Vienmēr piesaistiet avota PDF pirms izsaukt Save |
| Formas lauka vērtība nav ierakstīta | Lauka nosaukums neatbilst PDF iekšējam lauka nosaukumam | Izmantojiet Form.FieldNames, lai uzskaitītu pieejamos lauku nosaukumus |
| Apvienošana neizdodas klusi | Ievades fails ir šifrēts vai bojāts | Izmantojiet TryConcatenate un pārbaudiet atgriezto vērtību |
| Paraksti nav derīgi pēc rediģēšanas | Saturs tika modificēts pēc parakstīšanas | Parakstiet 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 / Method | Description |
|---|---|
Form | AcroForm saskarne lauku vērtību lasīšanai un rakstīšanai |
Form.FillField | Iestatīt veidlapas lauka vērtību pēc nosaukuma |
Form.GetField | Nolasīt veidlapas lauka vērtību pēc nosaukuma |
FormEditor | Pievienot vai modificēt veidlapas laukus esošā PDF |
PdfFileEditor | Apvienot, sadalīt, izvilkt un dzēst PDF lapu diapazonus |
PdfFileEditor.Concatenate | Apvienot divus vai vairākus PDF vienā |
PdfFileEditor.Extract | Izvilkt lapu diapazonu uz jaunu PDF |
PdfContentEditor | Modificēt lapas saturu (tekstu, anotācijas, darbības) |
PdfFileSignature | Parakstīt un pārbaudīt PDF digitālos parakstus |
PdfFileStamp | Pārklāt tekstu vai attēlu zīmogus uz lapām |
PdfConverter | Renderēt PDF lapas uz rastra attēliem |
FormattedText | Stilizēta teksta aprakstītājs zīmogu operācijām |
FontStyle | Fontu stilu uzskaitījums (treknraksts, slīpraksts utt.) |
EncodingType | Rakstzīmju kodējuma uzskaitījums |