1. محصولات
  2.   Aspose.Words
  3.   Aspose.Words FOSS for .NET

Aspose.Words FOSS برای .NET

ساخت، خواندن و ویرایش اسناد Word از .NET — رایگان و متن‌باز، ساخته‌شده با موتور واقعی Aspose.Words، بدون نیاز به Microsoft Word.

کتابخانهٔ منبع باز .NET برای اسناد Word

Aspose.Words FOSS for .NET یک کتابخانهٔ MIT-licensed pure-C# برای کار با فایل‌های Word .docx است. این کتابخانه بازنویسی یا wrapper نیست: این همان Aspose.Words برای کد منبع .NET است، همان موتور سندی که از سال 2003 اسناد Word را در تولید پردازش می‌کرده و به یک هستهٔ رایگان و منبع باز کاهش یافته است. کتابخانه همان Document Object Model مورد استفاده در محصول تجاری را در اختیار می‌گذارد — Document، DocumentBuilder، Section، Paragraph، Run، Table و صدها کلاس مرتبط دیگر. اسناد را از صفر ایجاد کنید یا اسناد موجود را باز کنید، متن، جدول‌ها، فهرست‌ها، سبک‌ها، سرصفحه‌ها و پاورقی‌ها، نشانک‌ها، نظرات و پاورقی‌ها را دستکاری کنید و بین DOCX، Markdown و متن ساده تبدیل کنید. یک موتور ارزیابی کامل فیلدها گنجانده شده است، به طوری که فیلدهایی مانند DATE، DOCPROPERTY و فیلدهای ادغام نامه به‌صورت برنامه‌نویسی به‌روز می‌شوند (فیلدهایی که به چینش صفحه وابسته‌اند، مانند شماره‌های صفحه، به مقادیر جایگزین ارزیابی می‌شوند زیرا چینش صفحه خود بخشی از این نسخه نیست). کتابخانه هدف .NET Standard 2.0 را دارد، بنابراین بر روی .NET Framework 4.6.2+، .NET 6/8/10، در ویندوز، لینوکس و macOS اجرا می‌شود و هیچ وابستگی بومی ندارد. آن را از طریق NuGet نصب کنید یا کتابخانه را از منبع بسازید (به پایین نگاه کنید). توسعه‌دهندگانی که به ویژگی‌های سازمانی و پشتیبانی تولیدی نیاز دارند می‌توانند Aspose.Words for .NET — Enterprise Product را همراه با این کتابخانه‌های منبع باز استفاده کنند.

ایجاد و ویرایش سند

  • Create and open DOCX: ساخت اسناد از ابتدا یا بارگذاری فایل‌های .docx موجود از طریق new Document() و new Document(path).
  • High-level authoring: با استفاده از DocumentBuilder متن را وارد کنید، مکان‌نما را به بخش‌ها و نشانک‌ها منتقل کنید، و قالب‌بندی قلم، پاراگراف و صفحه را در چند فراخوانی اعمال کنید.
  • Full document object model: به‌صورت مستقیم در درخت گره‌ها حرکت کنید، یا DocumentVisitor را زیرکلاس کنید تا هر نوع گره‌ای را پردازش کنید.
  • Combine and reorganize: با استفاده از DocumentBuilder سطح بالا و APIهای گره، محتوا را بین اسناد اضافه، کلون و وارد کنید.
  • Find and replace: جستجو و جایگزینی با استفاده از عبارات منظم و آگاهی از قالب‌بندی در سراسر سند.

جایی که می‌توان از Aspose.Words FOSS استفاده کرد

  • تولید سند: تولید گزارش‌ها، نامه‌ها و قراردادها از قالب‌ها بدون نصب Office.
  • مهاجرت محتوا: خواندن فایل‌های DOCX موجود و بازسازی، تغییر سبک یا استخراج محتوای آن‌ها.
  • خطوط لوله تبدیل فرمت: تبدیل DOCX به Markdown یا متن ساده برای ایندکس‌گذاری جستجو یا تولید سایت استاتیک.
  • پشت‌صحنه‌های بدون سرور: پردازش اسناد Word داخل کانتینرهای Docker یا توابع ابری بدون COM automation.
  • پردازش دسته‌ای اسناد: اعمال همان ویرایش‌ها بر روی مجموعه‌های بزرگ فایل‌های DOCX.

فیلدها، جداول و ساختار سند

  • Field evaluation engine: به‌روزرسانی فیلدهایی مانند DATE، DOCPROPERTY، REF، SEQ و فیلدهای ادغام ایمیل به‌صورت برنامه‌نویسی از طریق موتور کامل فیلد.
  • Tables and conditional formatting: ساخت و استایل‌دهی جداول با Table/Row/Cell، شامل قالب‌بندی شرطی برای هر ناحیه از طریق ConditionalStyle.
  • Lists: ایجاد، کپی و بازیابی تعاریف فهرست‌های شماره‌دار و بولت‌دار از طریق ListCollection و ListFormat.
  • Tracked changes: بررسی، پذیرش یا رد بازنگری‌ها با استفاده از RevisionCollection API.
  • Document protection: اعمال حفاظت با رمز عبور و اجرای حالت فقط-خواندنی از طریق enum DocumentSecurity.

تجربه توسعه‌دهنده

Aspose.Words FOSS یک C# خالص است که هدف‌گیری .NET Standard 2.0 را دارد — بدون افزونه‌های بومی برای کامپایل، بدون بسته‌های سیستمی برای نصب.
آن را از طریق NuGet نصب کنید، یا با یک فرمان dotnet build از منبع بسازید.

‏API مدل تجاری Aspose.Words را برای مدل شیء .NET بازتاب می‌دهد، بنابراین مستندات رسمی و مثال‌ها به‌طور گسترده‌ای در چارچوب ویژگی‌های پشتیبانی‌شده این نسخه اعمال می‌شوند.
این تحت مجوز MIT است و به‌صورت متن باز در GitHub موجود است.

یک سند با نمودار ایجاد کنید

از DocumentBuilder.InsertChart() برای افزودن یک شکل نمودار به سند استفاده کنید، سپس به شی Chart آن دسترسی پیدا کنید تا داده‌های سری را پیکربندی کنید. قبل از افزودن داده‌های واقعی، سری‌های پیش‌فرض تولید شده را پاک کنید.

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
using Aspose.Words;
using Aspose.Words.Drawing.Charts;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;

// Delete default generated series.
chart.Series.Clear();

string[] categories = new string[] `Chart`;
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });

doc.Save("chart.docx");

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

مدل مجوزدهی برای Aspose.Words FOSS for .NET چیست؟

Aspose.Words FOSS for .NET تحت مجوز MIT منتشر شده است. شما می‌توانید آن را در پروژه‌های شخصی، تجاری و بسته‌بندی‌شده بدون هزینه، بدون حق‌الامتیاز و بدون نیاز به کلید لایسنس زمان اجرا یا گام فعال‌سازی استفاده کنید.

چگونه Aspose.Words FOSS for .NET را نصب کنم؟

آن را از طریق NuGet نصب کنید، یا از منبع بسازید — مخزن را کلون کنید، راه‌حل را در پیکربندی Release بسازید، سپس یک مرجع پروژه به Aspose.Words.csproj از برنامه خود اضافه کنید.

کدام فرمت‌های فایل می‌تواند Aspose.Words FOSS for .NET بخواند و بنویسد؟

DOCX، DOCM، DOTX، DOTM و Flat OPC (به‌همراه انواع ماکرو‌دار و قالبی آن) برای هر دو بارگذاری و ذخیره‌سازی، به‌اشتراک‌گذاری یک خواننده/نویسندهٔ OOXML یکسان، به‌علاوه Markdown و متن ساده برای هر دو بارگذاری و ذخیره‌سازی.

آیا Aspose.Words FOSS for .NET می‌تواند اسناد را به فرمت‌های PDF، XPS یا تصویر صادر کند؟

نه. این نسخه شامل زیرسیستم صفحه-چیدمان و رندرینگ نیست، بنابراین Document.Save() نمی‌تواند به PDF، XPS یا فرمت‌های تصویر صادر شود. به‌جای آن به DOCX، DOCM، DOTX، DOTM، Flat OPC، Markdown یا متن ساده ذخیره کنید.

آیا Aspose.Words FOSS for .NET می‌تواند یک امضای دیجیتال بر روی سند ایجاد کند؟

خیر. این نسخه می‌تواند امضاهای دیجیتالی که قبلاً به یک فایل .docx پیوست شده‌اند را بررسی و تأیید کند، اما نمی‌تواند امضاهای جدید ایجاد کند. یک جریان کار امضای دیجیتال به Aspose.Words تجاری برای .NET نیاز دارد.

آیا این نسخه از اجرای mail merges، LINQ Reporting یا مقایسه اسناد پشتیبانی می‌کند؟

نه. اجرای Mail merge، گزارش‌گیری LINQ، مقایسه سند، و زیرمجموعه‌سازی قلم‌های جاسازی‌شده در این نسخهٔ FOSS گنجانده نشده‌اند.

  

منابع پشتیبانی و آموزش

 فارسی