GroupDocs.Conversion برای .NET 25.10 – نکات برجسته انتشار اکتبر 2025

ما خوشحالیم که GroupDocs.Conversion for .NET 25.10 را اعلام می‌کنیم، که از اکتبر 2025 در دسترس است.
این انتشار جزئی شامل مجموعه‌ای از بهبودهای چیدمان صفحه، قابلیت‌های جدید گزینه‌های بارگذاری و مجموعه‌ای از اصلاحات مهم باگ‌ها می‌شود. قابل‌توجه‌ترین تغییر، بازسازی عمومی API است که تنظیمات حاشیه و اندازه را در اشیای اختصاصی گروه‌بندی می‌کند و سازگاری را در تمام گزینه‌های تبدیل بهبود می‌بخشد.

چه چیزهای جدیدی در این نسخه وجود دارد

این افزوده‌ها به شما امکان می‌دهند قبل از گام تبدیل، چیدمان سند منبع را دقیقاً تنظیم کنید و کنترل بهتری بر ظاهر فایل‌های خروجی داشته باشید.

بازسازی API – تنظیمات چیدمان صفحه (تغییرات ناسازگار)

⚠️ تغییر ناسازگار (از نسخه v26.1 به بعد) – بیست ویژگی حاشیه/اندازه جداگانه منسوخ شده‌اند و در نسخهٔ بعدی اصلی حذف خواهند شد.
مدل جدید دو شیء کمکی معرفی می‌کند که جایگزین ویژگی‌های اسکالر قبلی می‌شوند:

کلاس‌های کمکی جدید

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; }   // Setting this forces PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // Setting this forces 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, // points (Letter width)
    PageHeight = 792  // points (Letter height)
};

روش جدید (پیشنهادی)

// اندازه پیش‌تعریف‌شده
var pdfOptions = new PdfConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageSize = PageSize.A4
    }
};

// ابعاد سفارشی
var wpOptions = new WordProcessingConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageWidth  = 612,   // points
        PageHeight = 792    // points
        // PageSize به‌طور خودکار به PageSize.Custom تبدیل می‌شود
    }
};

به کارگیری اشیای جدید ابهام را از بین می‌برد (API قبلی نقاط و پیکسل‌ها را ترکیب می‌کرد) و تمام گزینه‌های تبدیل را تحت یک مدل مشترک و قابل‌کشف یکپارچه می‌کند.

اصلاحات و بهبودها

این اصلاحات قابلیت اطمینان را در رایج‌ترین سناریوهای تبدیل تقویت می‌کند و کتابخانه را با رفتارهای مورد انتظار .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/

منابع

• یادداشت‌های کامل انتشار – (در صورت موجود بودن به صفحهٔ یادداشت‌های رسمی ارجاع داده شود)
• مستندات – https://docs.groupdocs.com/conversion/net/
• انجمن پشتیبانی – https://forum.groupdocs.com/c/conversion/12