API фасадів

Facades API

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, а не лише заповнювати вже наявні.

Загальні проблеми

Часті питання

У чому різниця між Facades та core Document API?

Фасади надають високорівневі, орієнтовані на завдання методи (заповнення форми, об’єднання файлів). Основний API (Document, Page, Annotation) надає низькорівневий доступ до кожного PDF‑об’єкта. Фасади використовують основний API внутрішньо.

Чи можу я ланцюжити кілька операцій фасаду?

Так. Прив’яжіть те саме джерело, виконайте операції та збережіть один раз. Або збережіть проміжний результат і повторно прив’яжіть для наступної операції.

Чи підтримує PdfFileEditor PDF‑файли, захищені паролем?

Так. Перевантаження, які приймають паролі власника/користувача, доступні для зашифрованих файлів.

Зведення довідки API

Див. також

• Aspose.PDF for .NET Enterprise Product