سوالات متداول
مجوزدهی و منبع باز
مدل مجوزدهی برای Aspose.Words FOSS برای .NET چیست؟
Aspose.Words FOSS برای .NET تحت مجوز MIT منتشر شده است. شما میتوانید آن را در پروژههای شخصی، تجاری و بستهبندیشده بدون هزینه استفاده کنید، بدون حق امتیاز و بدون نیاز به کلید مجوز زمان اجرا یا مرحله فعالسازی — تنها کافی است اطلاعیه حق کپیرایت و متن مجوز را همراه با هر نسخهای از نرمافزاری که توزیع میکنید، نگه دارید.
این نسخه FOSS چه تفاوتی با محصول تجاری Aspose.Words برای .NET دارد؟
Aspose.Words FOSS برای .NET بازنویسی یا بستهبندی نیست — در واقع Aspose.Words برای کد منبع .NET است که به هستهای رایگان و متن باز کاهش یافته است. این همان Document Object Model را همانند محصول تجاری ارائه میدهد (Document, DocumentBuilder, Section, Paragraph, Run, Table, و کلاسهای مرتبط)، اما زیرسیستم چیدمان صفحه و رندرینگ، چندین قالب قدیمی و سند باز، اجرای ادغام ایمیل، LINQ Reporting، مقایسه سند، و زیرنمونهسازی قلمهای توکار را حذف میکند. امضای دیجیتال میتواند تأیید شود اما ساخته نشود. برای جزئیات، سؤالهای مربوط به فرمت و محدودیتها را در زیر ببینید. توسعهدهندگانی که به مجموعه کامل ویژگیها نیاز دارند میتوانند از Aspose.Words برای .NET در کنار این منابع متن باز.
نصب و پیش‌نیازها
چگونه Aspose.Words FOSS برای .NET را نصب کنم؟
کتابخانه از طریق NuGet یا با ساخت از سورس در دسترس است. مخزن را کلون کنید و راهحل را در پیکربندی Release بسازید، سپس یک مرجع پروژه به Aspose.Words.csproj از برنامه خود اضافه کنید:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Releaseکدام نسخههای .NET و سیستمعاملها پشتیبانی میشوند؟
کتابخانه هدف .NET Standard 2.0 را دارد، بنابراین بر روی .NET Framework 4.6.2+ و .NET 6/8/10، در ویندوز، لینوکس و macOS اجرا میشود. این یک C# کاملاً مدیریتشده بدون وابستگیهای بومی است، بنابراین نیازی به نصب بستههای سیستمی اضافی نیست.
پشتیبانی از فرمت‌ها
کدام فرمتهای فایل میتوانند توسط Aspose.Words FOSS برای .NET خوانده و نوشته شوند؟
| فرمت | Load | Save |
|---|---|---|
| DOCX | بله | بله |
| DOCM | بله | بله |
| DOTX | بله | بله |
| DOTM | بله | بله |
| OPC مسطح (بهعلاوهٔ نسخههای ماکرو فعال و قالب) | بله | بله |
| Markdown | بله | بله |
| متن ساده | بله | بله |
فرمتهای DOCX، DOCM، DOTX، DOTM و Flat OPC همگی از یک خواننده/نویسندهٔ OOXML یکسان استفاده میکنند.
آیا میتوانم فایلهای DOC، RTF، ODT، HTML یا EPUB را بارگذاری یا ذخیره کنم؟
خیر. فهرست فرمتهای این نسخه تا DOCX، DOCM، DOTX، DOTM، Flat OPC، Markdown و متن ساده متوقف میشود — .doc، .rtf، .odt، .html و .epub خارج از این فهرست قرار دارند و باز کردن هر یک از این فایلها باعث بروز استثنا میشود.
آیا Aspose.Words FOSS برای .NET میتواند اسناد را به PDF، XPS یا فرمتهای تصویری صادر کند؟
خیر. این نسخه زیرسیستم چیدمان صفحه و رندرینگ را شامل نمیشود، بنابراین Document.Save() نمیتواند به PDF، XPS یا فرمتهای تصویری صادر شود.
بهجای آن به DOCX، DOCM، DOTX، DOTM، Flat OPC، Markdown یا متن ساده ذخیره کنید. نسخه تجاری Aspose.Words برای .NET قابلیتهای PDF، XPS و فرمتهای تصویری را اضافه میکند.
API Usage
چگونه یک سند جدید ایجاد کنم؟
یک Document بسازید، آن را در یک DocumentBuilder بپیچید و با استفاده از متدهای سطح بالای سازنده، محتوای موردنظر را قبل از ذخیرهسازی وارد کنید:
using Aspose.Words;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello, Aspose.Words FOSS!");
doc.Save("output.docx");چگونه یک سند DOCX موجود را بارگذاری کنم؟
مسیر فایل را به سازنده Document بدهید: new Document("input.docx"). همین سازنده همچنین یک Stream را میپذیرد و هر دو نسخهٔ بارگذاری دارند که یک شیء LoadOptions را برای کنترل دقیقتر نحوهٔ تجزیهٔ فایل میگیرند.
فیلدهایی مانند DATE یا DOCPROPERTY چگونه بهروز میشوند؟
Aspose.Words FOSS برای .NET شامل یک موتور کامل ارزیابی فیلد است، بنابراین فیلدهای محتوا مانند DATE، DOCPROPERTY، REF، SEQ و فیلدهای ادغام ایمیل بهصورت برنامهنویسی بهروز میشوند. فیلدهایی که به چیدمان صفحه وابستهاند — مانند شمارههای صفحه در فهرست مطالب — به جای مقدار محاسبهشده به یک جاینگهدارنده 0 ارزیابی میشوند، زیرا این نسخه موتور چیدمان را که معمولاً سند را صفحهبندی میکند، شامل نمیشود.
محدودیت‌های شناخته‌شده
آیا این نسخه از اجرای ادغام ایمیل، گزارش‌گیری LINQ یا مقایسه اسناد پشتیبانی میکند؟
خیر. اجرای ادغام ایمیل، گزارش‌گیری LINQ، مقایسه سند و زیر مجموعه‌سازی قلمهای توکار در این نسخه FOSS گنجانده نشده‌اند. کلاس‌هایی که تنظیمات و فیلدهای ادغام ایمیل را مدل‌سازی میکنند (مثلاً MailMergeSettings) در مدل شیء موجود هستند، اما اجرای واقعی یک ادغام بخشی از این نسخه نیست.
آیا Aspose.Words FOSS برای .NET میتواند یک امضای دیجیتال روی یک سند ایجاد کند؟
خیر. این نسخه میتواند امضاهای دیجیتال که قبلاً به یک فایل .docx پیوست شده‌اند را بررسی و تأیید کند — از طریق Document.DigitalSignatures، DigitalSignatureUtil.LoadSignatures() و کلاسهای DigitalSignature/DigitalSignatureCollection — اما قادر به ایجاد امضای جدید نیست. یک جریان کار امضا نیاز به Aspose.Words تجاری برای .NET دارد.
آیا زیر مجموعه‌سازی قلمهای توکار پشتیبانی میشود؟
نه. وقتی EmbedTrueTypeFonts فعال باشد، قلم‌ها به‌عنوان فایلهای کامل جاسازی میشوند نه اینکه به زیرمجموعه‌ای از گلیف‌های واقعاً استفاده‌شده در سند محدود شوند.
