Фасади API

Фасади API

Facades API предоставя опростени, ориентирани към задачи обвивки около основния Aspose.PDF FOSS for .NET модел на обекти. Всеки фасаден клас се фокусира върху конкретна PDF операция — попълване на формуляри, конкатениране на файлове, редактиране на съдържание или цифрово подписване — и излага BindPdf / Save работен процес.

Попълване на формуляри с фасадата Form

Form (в Aspose.Pdf.Facades) се свързва с съществуващ PDF и ви позволява да четете или записвате стойности на полета от AcroForm, без да навигирате в дървото на страниците.

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

За четене на стойностите на полетата:

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

Сливане и разделяне на PDF файлове с PdfFileEditor

PdfFileEditor конкатенира, разделя, извлича и изтрива диапазони от страници.

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

Редактиране на съдържанието на страницата с PdfContentEditor

PdfContentEditor модифицира съществуващото съдържание на страницата — добавя текст, заменя текст или прикрепя действия към анотациите.

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

Цифрови подписи с PdfFileSignature

PdfFileSignature подписва PDF документи и проверява съществуващите подписи.

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

Маркиране на страници с PdfFileStamp

PdfFileStamp надлага текст, изображения или други PDF страници като печати.

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

Конвертиране на страници в изображения с PdfConverter

PdfConverter рендерира PDF страници в растерни формати за изображения.

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

Съвети и най‑добри практики

• Винаги извиквайте Close() или използвайте using, за да освободите ресурсите, задържани от фасадните обекти.
• Използвайте BindPdf с път към файл за големи файлове, за да избегнете зареждане на всичко в паметта наведнъж.
• Предпочитайте TryConcatenate и TryAppend пред техните версии без Try за елегантно обработване на грешки.
• Фасадите делегират към основния модел Document вътрешно — преминете към основното API, когато се нуждаете от фино управление.
• Фасадата FormEditor позволява добавяне на нови полета за формуляри към съществуващ PDF, а не само попълване на съществуващите.

Чести проблеми

ЧЗВ

Каква е разликата между фасадите и основния Document API?

Фасадите предоставят високониво, ориентирани към задачи методи (попълване на формуляр, обединяване на файлове).
Основният API (Document, Page, Annotation) осигурява достъп на по-ниско ниво до
всеки PDF обект. Фасадите използват основния API вътрешно.

Мога ли да свържа няколко фасадни операции?

Да. Свържете същия източник, извършете операции и запазете еднократно. Или запазете междинен резултат и повторно свържете за следващата операция.

Поддържа ли PdfFileEditor PDF файлове, защитени с парола?

Да. Претоварвания, които приемат пароли за собственик/потребител, са налични за криптирани файлове.

Обобщение на API справката

Вижте също

• Aspose.PDF for .NET Enterprise продукт