مبدل سند Aspose.Words برای .NET

Aspose.Words Document Converter برای .NET یک API سبک و با عملکرد بالا است که بر روی format-to-format conversion متمرکز است. آن را پشتیبانی از سناریوهای رایج مانند Word → PDF، HTML → pdf**، DOCX ↔ ODT*, * DOCX → Markdown** ، PDF → تصاویر (JPG/PNG/TIFF) و ده ها نفر دیگر بدون نیاز به مایکروسافت آفیس.

نصب و نصب

  • نصب بسته NuGet Aspose.Words (تغییرمسیرهای هسته ای).
  • درخواست مجوز اندازه گیری شده در استارتاپ برای جلوگیری از محدودیت های ارزیابی: مشاهده مجوز متریکی .
  • بررسی نیازهای چارچوبی در راهنمای نصب .

پلتفرم های پشتیبانی شده

  • ویندوز، لینوکس، macOS
  • مجموعه ها: .NET Framework 4.x، .NET Standard 2.0،.NET Core 2.0-3.1 و .NET 5/6/7
  • IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop

شروع سریع

1) کلمه → PDF (یک خط) 

using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");

2) HTML → PDF با گزینه ها 

using Aspose.Words;
using Aspose.Words.Saving;

var doc = new Document("input.html");
var pdf = new PdfSaveOptions
{
    Compliance = PdfCompliance.PdfA1b,    // archival
    EmbedFullFonts = false,               // reduce size
    OptimizationOptions = { ImageCompression = PdfImageCompression.Jpeg }
};
doc.Save("output.pdf", pdf);

3) DOCX → Markdown 

using Aspose.Words;
using Aspose.Words.Saving;

var doc = new Document("spec.docx");
var md = new MarkdownSaveOptions
{
    TableContentAlignment = MarkdownTableContentAlignment.Auto,
    ListExportMode = MarkdownListExportMode.PlainText
};
doc.Save("spec.md", md);

4) PDF → تصاویر (در هر صفحه) 

using Aspose.Words;
using Aspose.Words.Saving;

var pdfDoc = new Document("report.pdf");
var img = new ImageSaveOptions(SaveFormat.Png) { Resolution = 200 };
for (int page = 0; page < pdfDoc.PageCount; page++)
{
    img.PageSet = new PageSet(page);
    pdfDoc.Save($"report_page_{page + 1}.png", img);
}

5) جریان → جریان (ویب / سرویس) 

using (var input = httpFile.OpenReadStream())
using (var output = new MemoryStream())
{
    var doc = new Aspose.Words.Document(input);   // auto-detects format
    doc.Save(output, SaveFormat.Pdf);
    output.Position = 0;
    return File(output.ToArray(), "application/pdf", "converted.pdf");
}

ویژگی ها و عملکرد

پوشش گسترده

واردات / خروجی ( انتخاب شده):

  • خانواده کلمه: DOC، DOCX، DOT، RTF، WordML (XML)
  • **تنظیمات ثابت: ** PDF, از بایگانی برچسب ها: EPUB/)

ماتریکس کامل با قابلیت های Aspose.Words مطابقت دارد.اگر هر دو پلاگین پردازنده فایل و این Converter در دسترس هستند، شما می توانید ابتدا بارگذاری / ویرایش و سپس صادرات در فرمت مورد نظر.

تشخیص فرمت اتوماتیک

API فرمت را از **فایلهای ** یا **محتویات جریان ** تشخیص می دهد، بنابراین شما می توانید به طور ایمن بارگذاری های خودخواهانه در سرویس های وب را بپذیرید.

Fine-Tuning با گزینه های ذخیره سازی

  • PDF: PDF/A‐1b/2u، رمزگذاری، پرچم های مجوز، امضای دیجیتال، ادغام فونت، فشرده سازی تصویر.
  • HTML/MHTML: مدیریت منابع (در مقابل خارجی)، حالت CSS، رمزگذاری، فرمت تصویر و DPI.
  • تصویر: DPI، عمق رنگ، فشرده سازی، محدوده صفحه، چند صفحه TIFF.
  • Markdown: لیست و سبک های عنوان، هماهنگی جدول، تولید لینک.

Layout وفاداری و Metadata

حفظ فونت، سبک ها، میزها، عنوان ها/پایه ها و نشانه های آب، نظرات، شکاف های بخش و ** ویژگی های سند** ( نویسنده، نام، زمینه های سفارشی) می تواند به صورت برنامه نویسی در طول تبدیل تبدیل شود.

پردازش دوستانه سرور

  • آیای جریان-اولین ، توزیع کم، بوفری I/O.
  • Async/batch تبدیل و موازی برای عبور.
  • تنظیم حافظه و محدوده پردازش صفحه برای داک های بزرگ.

تشخیص و مقاومت

استثناهای روشن در ورودی های فاسد / نامناسب؛ ورود به سوابق / تلومتری برای گرفتن مدت زمان، شمارش صفحات و دلایل شکست SLA ردیابی.

دستورالعمل تبدیل محبوب

  • **DOCX → PDF/XPS ** برای توزیع و آرشیو (به صورت اختیاری PDF/A).
  • HTML → PDF برای صورتحساب ها، بیانیه ها و گزارش ها با صفحه سازگار.
  • DOCX ↔ ODT برای تعاملات متقاطع.
  • DOCX → Markdown برای انتشار Docs تکنولوژیکی.
  • PDF → PNG/JPEG/TIFF برای ایجاد پیش نمایش ها و یا خلاصه ها.
  • Word/HTML → EPUB برای جریان های کار کتاب الکترونیکی.

نکته: استفاده از PageSet برای صادرات صفحات یا شاخه های خاص؛ ترکیب باImageSaveOptions برای اسفناج ها یا تومانیل ها.

بهترین شیوه‌ها

  • License first : شروع مجوز اندازه گیری قبل از هر تبدیل برای اجتناب از ارزیابی شاخص های آب.
  • ترجیح می دهم در سرویس ها جریان داشته باشد تا دیسک I/O را از بین ببرد و تاخیر را کاهش دهد.
  • تولید زود : بایت های جادویی را بررسی کنید یا سعی کنید بار خشک را به سرعت شکست دهید.
  • **تولید در اندازه مناسب ** : DPI حساس را انتخاب کنید، از قرار دادن هر فونت اجتناب کنید مگر اینکه لازم باشد؛ PDF/A را فقط در صورت نیاز به رعایت کنید.
  • بهداشت منابع : چرخش Document و جریان در using بلوک ها.
  • تبادل ارز : استفاده کوتاه مدت Document مثال ها بر اساس درخواست؛ استفاده از استخر برای گزینه ها در صورت لزوم.
  • قابل مشاهده : تعداد صفحات سوابق، مدت ها و مجموعه های گزینه؛ برچسب شکست ها با شناسه های ارتباطی.

FAQ

**آیا نیاز به مایکروسافت Office دارد?**نه، این یک آتش نشانی است.

**آیا می توانم بدون لمس سیستم فایل تبدیل کنم?**بله، همه تبدیل ها می توانند Stream → Stream باشند.

**چگونه می توانم PDF / A را اجرا کنم?**تنظیمات PdfSaveOptions.Compliance = PdfCompliance.PdfA1b (یا 2U) قبل از صرفه جویی.

**آیا می توانم رمز عبور PDF ها را محافظت کنم?**بله. تنظیم رمزگذاری و اجازه پرچم در PdfSaveOptions.

**آیا Markdown round-trip امن است?**طرح های پیچیده را می توان نزدیک کرد. جدول ها، لیستها، عناوین، لینک ها و فرمت در خط با گزینه های قابل چرخش پشتیبانی می شود.

**چگونه می توانم صفحات خاص را تبدیل کنم?**استفاده PageSet در ImageSaveOptions یا FixedPageSaveOptions‑کلاس های مشتق شده.

 فارسی