واسط‌ها API

واسط‌ها API

API فاسادها رابط‌های ساده‌شده و کار‑محور را در اطراف مدل شیء اصلی Aspose.PDF FOSS برای .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 برای آزادسازی منابع نگه‌داشته‌شده توسط اشیای facade استفاده کنید.
• برای فایل‌های بزرگ از BindPdf همراه با مسیر فایل استفاده کنید تا از بارگذاری همه چیز در حافظه به‌صورت همزمان جلوگیری شود.
• برای مدیریت خطای نرم، TryConcatenate و TryAppend را به‌جای نسخه‌های غیر‑Try آن‌ها ترجیح دهید.
• Facades به‌صورت داخلی به مدل هسته‌ای Document واگذار می‌شوند — وقتی به کنترل دقیق‌تری نیاز دارید، به API هسته‌ای سوئیچ کنید.
• facade FormEditor امکان افزودن فیلدهای فرم جدید به یک PDF موجود را می‌دهد، نه فقط پر کردن فیلدهای موجود.

مسائل رایج

سوالات متداول

تفاوت بین Facades و core Document API چیست؟

واسط‌ها روش‌های سطح بالا و مبتنی بر وظیفه (پر کردن فرم، ادغام فایل‌ها) را فراهم می‌کنند. API هسته (Document، Page، Annotation) دسترسی سطح پایین به هر شیء PDF را می‌دهد. واسط‌ها از API هسته به‌صورت داخلی استفاده می‌کنند.

آیا می‌توانم چندین عملیات facade را به‌صورت زنجیره‌ای انجام دهم؟

بله. همان منبع را بایند کنید، عملیات را انجام دهید و یک‌بار ذخیره کنید. یا ذخیره کنید نتیجه میانی را و برای عملیات بعدی دوباره بایند کنید.

آیا PdfFileEditor از PDFهای محافظت‌شده با رمز عبور پشتیبانی می‌کند؟

بله. Overloads که رمزهای عبور مالک/کاربر را می‌پذیرند برای فایل‌های رمزگذاری‌شده در دسترس هستند.

خلاصه مرجع API

همچنین ببینید

• Aspose.PDF برای .NET محصول Enterprise