نحن سعداء بالإعلان عن GroupDocs.Conversion for .NET 25.10، المتاح اعتبارًا من أكتوبر 2025.
هذا الإصدار الصغير يجلب مجموعة من تحسينات تخطيط الصفحات، وقدرات جديدة لخيارات التحميل، وعدد قليل من إصلاحات الأخطاء الحرجة. أكثر التغييرات وضوحًا هو إعادة هيكلة عامة لواجهة البرنامج (API) التي تجمع إعدادات الهوامش والحجم في كائنات مخصصة، مما يحسن التناسق عبر جميع خيارات التحويل.

ما الجديد في هذا الإصدار

المعرف الميزة
CONVERSIONNET‑8032 إضافة دعم لتعيين حجم الصفحة، الهوامش والاتجاه في EmailLoadOptions قبل التحويل.
CONVERSIONNET‑8013 إضافة دعم لتعيين هوامش الصفحة في SpreadsheetOptions قبل التحويل.
CONVERSIONNET‑8012 إضافة دعم لتعيين حجم الصفحة في SpreadsheetOptions قبل التحويل.
CONVERSIONNET‑8009 إضافة دعم لتعيين حجم الصفحة في TxtLoadOptions وWordProcessingLoadOptions قبل التحويل.
CONVERSIONNET‑8008 إضافة دعم لتعيين هوامش الصفحة في TxtLoadOptions وWordProcessingLoadOptions قبل التحويل.

تتيح هذه الإضافات ضبط تخطيط المستند المصدر قبل خطوة التحويل، مما يمنحك سيطرة أكبر على مظهر الملفات الناتجة.

إعادة هيكلة الـ API – إعدادات تخطيط الصفحة (تغييرات كاسرة)

⚠️ تغيير كاسر (ساري ابتداءً من v26.1) – تم إهلاك عشرين خاصية هوامش/أحجام منفصلة وسيتم إزالتها في الإصدار الرئيسي التالي.
النموذج الجديد يقدم كائنين مساعدين يحلان محل الخصائص الفردية السابقة:

الفئة المتأثرة الخصائص المهملة البديل
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) نفس ما هو في PDF نفس ما هو في PDF
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

الكائنات المساعدة الجديدة

public class PageMarginOptions
{
    public float? Top { get; set; }
    public float? Bottom { get; set; }
    public float? Left { get; set; }
    public float? Right { get; set; }
}

public sealed class PageSizeOptions
{
    public PageSize PageSize { get; set; }
    public float PageWidth { get; set; }   // ضبط هذا يجعل PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // ضبط هذا يجعل PageSize = PageSize.Custom
}

دليل الترحيل

ترحيل هوامش الصفحة

الطريقة القديمة (مهملة)

var options = new PdfConvertOptions
{
    MarginTop    = 10,
    MarginBottom = 10,
    MarginLeft   = 20,
    MarginRight  = 20
};

الطريقة الجديدة (مستحسنة)

var options = new PdfConvertOptions
{
    MarginSettings = new PageMarginOptions
    {
        Top    = 10,
        Bottom = 10,
        Left   = 20,
        Right  = 20
    }
};

ترحيل إعدادات حجم الصفحة

الطريقة القديمة (مهملة)

// حجم مُعرّف مسبقًا
var pdfOptions = new PdfConvertOptions
{
    PageSize = PageSize.A4
};

// أبعاد مخصصة
var wpOptions = new WordProcessingConvertOptions
{
    PageWidth  = 612, // نقاط (عرض Letter)
    PageHeight = 792  // نقاط (ارتفاع Letter)
};

الطريقة الجديدة (مستحسنة)

// حجم مُعرّف مسبقًا
var pdfOptions = new PdfConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageSize = PageSize.A4
    }
};

// أبعاد مخصصة
var wpOptions = new WordProcessingConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageWidth  = 612,   // نقاط
        PageHeight = 792    // نقاط
        // يتحول PageSize تلقائيًا إلى PageSize.Custom
    }
};

اعتماد الكائنات الجديدة يزيل الغموض (كانت الواجهة القديمة تخلط بين النقاط والبكسل) ويجعل جميع خيارات التحويل تحت نموذج موحد يمكن اكتشافه بسهولة.

الإصلاحات والتحسينات

المعرف نوع المشكلة الوصف
CONVERSIONNET‑8031 خطأ تم تجاهل PreserveOriginalDate عندما تُعيّن إلى false في .NET.
CONVERSIONNET‑8023 خطأ فشلت التحويلات بصيغة Fluent‑syntax عندما لم تُمرَّ خيارات تحويل صريحة.
CONVERSIONNET‑8020 خطأ ألقى تحويل WordProcessing استثناءً غير مُعالَج بسبب عدم وجود Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 خطأ عالج WordProcessingConvertOptions خصائص PageWidth/PageHeight كبيكسل بدلًا من نقاط.
CONVERSIONNET‑8005 خطأ لم تُحترم خصائص PdfConvertOptions.Margin* أثناء تحويل PDF.

تُعزز هذه الإصلاحات موثوقية المكتبة في أكثر سيناريوهات التحويل شيوعًا وتُطابق سلوك .NET المتوقع.

كيفية الحصول على التحديث

  • NuGet – قم بالترقية إلى أحدث نسخة من حزمة GroupDocs.Conversion:

    dotnet add package GroupDocs.Conversion --version 25.10

    (تعمل الحزمة نفسها على .NET 6+، .NET Framework 4.6.2، و.NET Core.)

  • تحميل مباشر – التجميعات لكل من .NET و .NET Framework متوفرة على صفحة الإصدار:
    https://releases.groupdocs.com/conversion/net/25-10/

موارد