نکات جدید در GroupDocs.Conversion برای .NET 26.1 (ژانویه 2026)

دسته‌بندی شناسه توضیح
ویژگی CONVERSIONNET-8080 پشتیبانی کامل از وارد و صادر کردن فرمت FlatOpc (Flat XML) برای اسناد Word، Excel و PowerPoint.
بهبود CONVERSIONNET-4551 رفع مشکل تبدیل نادرست فایل‌های PDF که شامل تصاویر هستند به شيت‌های Excel.
بهبود CONVERSIONNET-8147 بازیابی اسمبلی ضروری Aspose.Drawing، که خطاهای زمان اجرا Could not load file or assembly را هنگام پردازش فایل‌های تصویری و Visio از بین می‌برد.
بهبود CONVERSIONNET-8153 اصلاح نحوه‌ی پردازش مهرها به‌گونه‌ای که دیگر مهرها با متن «Draft» جایگزین نمی‌شوند وقتی MarginSettings در حین تبدیل PDF فعال باشد.
بهبود CONVERSIONNET-8157 رفع بارگذاری منبع واترمارک نمودار پس از ابهام‌زدایی کد.
رفع امنیتی CONVERSIONNET-8164 رفع آسیب‌پذیری‌های Server‑Side Request Forgery (SSRF) و نشت اعتبار‌نامه NTLM. ویژگی SkipExternalResources به‌صورت پیش‌فرض برای چندین کلاس گزینه‑بارگذاری به true تنظیم شد.
بهبود CONVERSIONNET-8170 فهرست مطالب (Table of Contents) دیگر به‌صورت خودکار به‌روز نمی‌شود مگر اینکه UpdateFields صراحتاً به true تنظیم شود.
بهبود CONVERSIONNET-8185 رفع مشکل تبدیل فایل‌های Excel FlatOpc به فرمت‌های SVG و SVGZ.

نکات برجستهٔ اصلی

  • پشتیبانی از FlatOpc (Flat XML) – بارگذاری و ذخیره‌سازی فایل‌های Word، Excel و PowerPoint به‌صورت یک نمای XML تک‌فایل.
  • دقت تبدیل – خروجی قابل اطمینان Excel FlatOpc → SVG/SVGZ و استخراج صحیح تصاویر از PDF به Excel.
  • امنیت افزوده – کاهش خطر SSRF و نشت اعتبار‌نامه‌های NTLM؛ منابع خارجی به‌صورت پیش‌فرض نادیده گرفته می‌شوند.
  • وابستگی‌های پایدار – بسته شدن وابستگی گمشده Aspose.Drawing که از خطاهای بارگذاری اسمبلی جلوگیری می‌کند.
  • رفتار پیش‌بینی‌پذیر سند – به‌روزرسانی TOC و رندر مهرها حالا با تنظیمات صریح تبدیل سازگار است.

تغییرات API عمومی (سازگار با نسخه‌های قبلی)

ویژگی Format در چندین کلاس گزینه‑بارگذاری و تبدیل، الآن مقادیر جدید enum برای پردازش FlatOpc را می‌پذیرد.

کلاس ویژگی مقدار enum جدید
WordProcessingLoadOptions Format WordProcessingFileType.FlatOpc
SpreadsheetLoadOptions Format SpreadsheetFileType.FlatOpc
WordProcessingConvertOptions Format WordProcessingFileType.FlatOpc
SpreadsheetConvertOptions Format SpreadsheetFileType.FlatOpc

توجه: هیچ API حذف‌نشده‌ای وجود ندارد. کدهای موجود همچنان کار می‌کنند؛ تنها کافی است در صورت نیاز مقدار enum جدید FlatOpc را اختصاص دهید.

نمونه‌های کد

1. تبدیل فایل Word FlatOpc به PDF

using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new WordProcessingLoadOptions
{
    Format = WordProcessingFileType.FlatOpc
};

using (var converter = new Converter("document.xml", () => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("output.pdf", options);
}

2. تبدیل یک فایل DOCX به Word FlatOpc

using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;

using (var converter = new Converter("document.docx"))
{
    var options = new WordProcessingConvertOptions
    {
        Format = WordProcessingFileType.FlatOpc
    };
    converter.Convert("output.word.xml", options);
}

3. تبدیل فایل Excel FlatOpc به PDF

using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new SpreadsheetLoadOptions
{
    Format = SpreadsheetFileType.FlatOpc
};

using (var converter = new Converter("spreadsheet.xml", () => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("output.pdf", options);
}

4. تبدیل یک فایل XLSX به Excel FlatOpc

using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;

using (var converter = new Converter("spreadsheet.xlsx"))
{
    var options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.FlatOpc
    };
    converter.Convert("output.excel.xml", options);
}

نحوه دریافت به‌روزرسانی

  • NuGet – ارتقاء به آخرین بسته:

    Install-Package GroupDocs.Conversion -Version 26.1.0

    (یا به‌روزرسانی از طریق UI NuGet در Visual Studio).

  • دانلود مستقیم – اسمبلی‌ها برای .NET 6 / .NET Framework می‌توانند از صفحهٔ رسمی انتشار GroupDocs دانلود شوند، به‌محض این‌که منتشر گردد.

منابع