سوالات متداول — Aspose.PDF FOSS برای .NET
مجوزدهی و منبع باز
مدل مجوزدهی برای Aspose.PDF FOSS برای .NET چیست؟
Aspose.PDF FOSS for .NET تحت مجوز MIT منتشر شده است. شما میتوانید این کتابخانه را بهصورت رایگان استفاده، کپی، اصلاح و توزیع کنید، حتی در محصولات تجاری، بدون خرید مجوز تجاری. کد منبع بهصورت عمومی در GitHub در دسترس است.
آیا میتوانم Aspose.PDF FOSS برای .NET در نرمافزارهای تجاری استفاده کنم؟
بله. مجوز MIT اجازه استفاده در برنامههای مالکیتی و تجاری را بدون هزینههای زمان اجرا میدهد. شما فقط ملزم به نگه داشتن اعلان مجوز در هر نسخه توزیعشده یا بخش قابل توجهی از کتابخانه هستید.
آیا به یک کلید لایسنس Aspose یا لایسنس متری نیاز دارم؟
برای Aspose.PDF FOSS نیازی به کلید لایسنس نیست. ویژگی Document.IsLicensed وضعیت داخلی لایسنس را نشان میدهد اما نیازی به مرحله فعالسازی نیست — کتابخانه بهصورت کامل بدون لایسنس و بدون هزینه اجرا میشود.
نصب و الزامات
چگونه Aspose.PDF FOSS را برای .NET نصب کنم؟
نصب از NuGet با استفاده از .NET CLI:
dotnet add package Aspose.Pdf.Foss --version 0.1.0-alphaیا این را به فایل پروژه خود اضافه کنید:
<PackageReference Include="Aspose.Pdf.Foss" Version="0.1.0-alpha" />کدام نسخه .NET مورد نیاز است؟
Aspose.PDF FOSS هدفگذاری شده برای .NET 8 و نسخههای بعدی است. این کتابخانه از .NET Framework، .NET Standard یا نسخههای قبلی .NET Core پشتیبانی نمیکند. اطمینان حاصل کنید که پروژه شما net8.0 یا بالاتر را در فایل .csproj هدفگذاری کرده است.
آیا وابستگیهای بومی یا ابزارهای خارجی مورد نیاز هستند؟
نه. Aspose.PDF FOSS یک کتابخانه کاملاً مدیریتشدهٔ .NET است که هیچ باینری بومی غیرمدیریتشدهای ندارد و به Adobe Acrobat، Ghostscript یا هر ابزار خارجی دیگری وابسته نیست.
پشتیبانی از فرمت
کدام فرمتها توسط Aspose.PDF FOSS برای .NET پشتیبانی میشود؟
کتابخانه فرمت PDF را میخواند و مینویسد. متد Document.Open آرایههای بایت، مسیرهای فایل و استریمها را میپذیرد. متدهای Document.Save و Document.ToArray خروجی PDF تولید میکنند. خروجی تصویر (برای رندر صفحات) توسط enum ImageFormat کنترل میشود که از BMP، GIF، JPEG، PNG، TIFF و سایر فرمتهای رستر پشتیبانی میکند.
آیا Aspose.PDF FOSS میتواند صفحات PDF را به تصویر تبدیل کند؟
بله. رندر صفحه به فرمتهای رستر از طریق enum ImageFormat پشتیبانی میشود که شامل Bmp، Jpeg، Png، Gif، Tiff و Emf است. کلاسهای دستگاه خاص مسیر رندر را مدیریت میکنند.
استفاده از API
چگونه یک سند PDF جدید ایجاد کنم؟
از Document.Create() برای تولید یک سند خالی استفاده کنید، سپس صفحات را اضافه کنید و ذخیره کنید:
using var doc = Document.Create();
// add pages, content, annotations
using var ms = new MemoryStream();
doc.Save(ms);
byte[] pdfBytes = ms.ToArray();چگونه یک PDF موجود را از مسیر فایل یا آرایه بایت باز کنم؟
// From file path
using var doc = Document.Open("input.pdf");
// From byte array
byte[] data = File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
// From stream
using var stream = File.OpenRead("input.pdf");
using var doc = Document.Open(stream);چگونه میتوانم چندین سند PDF را ادغام کنم؟
از Document.Merge برای ترکیب چندین سند استفاده کنید:
var merged = Document.Merge(new[] { doc1, doc2, doc3 });
merged.Save("combined.pdf");Document.MergeDocuments یک overload معادل است که مسیرهای فایل را بهصورت مستقیم میپذیرد.
محدودیتهای شناختهشده
آیا کتابخانه از نظر ویژگیها کامل است نسبت به نسخه تجاری Aspose.PDF؟
نه. Aspose.PDF FOSS یک زیرمجموعه منبع باز است. برخی ویژگیهای تجاری پیشرفته — مانند رندر کامل فرم XFA، تبدیل PDF/A، امضای دیجیتال (PKCS7) و برخی عملیات خطیسازی — ممکن است بهطور جزئی پیادهسازی شده یا غایب باشند. برای وضعیت فعلی ویژگیهای خاص، پیگیریکننده مسائل GitHub را بررسی کنید.
آیا افزونههای JavaScript AcroForm بهطور کامل پشتیبانی میشوند؟
کلاسهای FieldDateTimeFormatter، FieldNumberCurrencyFormatter و FieldNumberPercentFormatter معادل توابع AF_Date_Format، AF_Number_Format و AF_Percent_Format در PDF JavaScript را برای قالببندی فیلدها در سمت سرور بدون نیاز به موتور JavaScript پیادهسازی میکنند. اینها در نسخه آلفای فعلی در دسترس هستند.