محول مستند Aspose.Words لـ .NET

Aspose.Words Document Converter for .NET هو API خفيفة الوزن وذات الأداء العالي يركز على format-to-format conversion. فإنه يدعم السيناريوهات الشائعة مثل Word → PDF، HTML ↔ ODT، DOCX → Markdown, PDF → images (JPG/PNG/TIFF) وغيرها عشرات – دون الحاجة إلى Microsoft Office.

تثبيت وإعداد

  • قم بتثبيت حزمة NuGet Aspose.Words (القوة النووية API التحويلات).
  • تطبيق الترخيص المقياس في الشركات الناشئة لتجنب حدود التقييم: انظر ترخيص مقيد .
  • مراجعة متطلبات الإطار في دليل التركيب .

منصات مدعومة

  • نظام التشغيل: Windows، Linux، macOS
  • الإطارات: .NET Framework 4.x، .NET Standard 2.0، و.NET Core 2.0–3.1، ونيت 5/6/7+، Mono
  • IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop

بدء سريع

1) Word → 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 – البث على شبكة الإنترنت (web/service) 

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.إذا كان كل من **File Processor ** و Converter متواجدين، يمكنك تحميل/تحرير أولا ثم تصدير في النموذج المطلوب.

الكشف التلقائي عن النمط

يكتشف API تنسيقًا من عناوين الملفات أو محتوى التدفق ، بحيث يمكنك قبول التحميلات العشوائية بأمان في خدمات الويب.

Fine-Tuning مع خيارات حفظ

  • PDF: PDF/A‐1b/2u، التشفير، علامات السماح، توقيعات رقمية، إدراج الخطوط، ضغط الصورة.
  • HTML/MHTML: التعامل مع الموارد (مخفية مقابل خارجية) ، وضع CSS ، التشفير ، تنسيق الصورة و DPI.
  • الصور: DPI، عمق اللون، ضغط، نطاق الصفحة، TIFF متعددة الصفحات.
  • Markdown: قائمة وأساليب العناوين، توحيد الجدول، توليد الروابط.

تداول الخيارات الثنائية Fidelity & Metadata

يحافظ على الخطوط والأساليب والجدول والألقاب/الخطوط والعلامات المائية والتعليقات والانقطاع و ** خصائص الوثيقة** (المؤلف، العنوان، الحقول المخصصة.

معالجة الخادم ودية

  • تدفق-أول APIs، منخفضة التخصيص، بوفير I/O.
  • Async/batch التحويل والتوازن للخروج.
  • الحد الأقصى للذاكرة ومعالجة الصفحات قابلة للتعديل لـ Docs الكبيرة.

التشخيص والمقاومة

استثناءات واضحة على الإدخالات المفسدة / غير المدعومة ؛ الاهتزاز في تسجيل الدخول / التلميذ لالتقاط المدة ، وعدد الصفحات ، وأسباب الفشل سلا التتبع.

وصفات تحويل شعبية

  • **DOCX → PDF/XPS ** للتوزيع والأرشيف (اختياريًا PDF/A).
  • HTML → PDF للحسابات والتصريحات والتقارير مع صفحة متسقة.
  • DOCX ↔ ODT للتفاعل بين السواحل.
  • DOCX → Markdown لنشر التقنيات.
  • PDF → PNG/JPEG/TIFF لإنتاج مقاطع الفيديو أو المفاتيح.
  • Word/HTML → EPUB لتدفقات عمل الكتب الإلكترونية.

نصيحة: استخدم **PageSet ** لتصدير صفحات أو مستويات محددة؛ ودمج مع ImageSaveOptions للحصول على الشرائح أو الألواح الصغيرة.

أفضل الممارسات

  • الترخيص أولا : بدء الترخيص المقياس قبل أي تحويلات لتجنب تقييم علامات المياه.
  • أفضل التدفقات في الخدمات لتخفيف القرص I/O والحد من التأخير.
  • التأكيد في وقت مبكر : فحص بايتات السحر أو محاولة تحميل جاف لتفشل بسرعة.
  • **مصدر الحجم الصحيح ** : اختر DPI الحساس، تجنب إدراج كل حرف ما لم يكن مطلوبا؛ اختر PDF/A فقط عند الحاجة إلى الامتثال.
  • النظافة الموارد : الحفرة Document وتدفق في using الكتل.
  • العملة النقدية : استخدام قصير العمر Document الحالات حسب الطلب؛ توظيف حوض السباحة للخيارات إذا لزم الأمر.
  • ملاحظة : حسابات صفحة السجل، ومدة، ومجموعات الخيارات، وتسمية الفشل مع معرفات الترابط.

FAQ

**هل يتطلب ذلك Microsoft Office?**لا، إنها إطلاق نار مستقل.

**هل يمكنني تحويل دون لمس نظام الملفات?**نعم، يمكن أن تكون جميع التحويلات Stream → Stream.

**كيف يمكنني تنفيذ PDF/A?**إعداد PdfSaveOptions.Compliance = PdfCompliance.PdfA1b (أو 2U) قبل الادخار.

**هل يمكنني حماية كلمات المرور من PDFs?**نعم.إعداد التشفير والعلامات السماح في PdfSaveOptions.

**هل Markdown round-trip آمنة?**ويمكن تقليص التصاميم المعقدة.يتم دعم اللوحات والقوائم والعناوين والروابط والتصميم في الخط مع الخيارات القابلة للتحويل.

**كيف يمكنني تحويل صفحات محددة?**استخدام PageSet في ImageSaveOptions أو FixedPageSaveOptions‑طبقات مشتقة.

 عربي