نحن سعداء بالإعلان عن إصدار GroupDocs.Merger for .NET v26.10، المتاح اعتبارًا من أكتوبر 2026. يقدم هذا الإصدار تحسينات رئيسية للتحكم في تحميل الموارد الخارجية، يحل مشكلات التزامن الحرجة في معالجة EPUB وTeX، يحسن ترقيم صفحات EPUB، يحافظ على تنسيق PDF والعنوان في المخرجات ذات العلامة التلقائية، ويصلح عدة أخطاء متعلقة بـ .NET Framework. بشكل عام، يتضمن 10 ميزات وتحسينات وإصلاحات أخطاء.

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

  • [Feature] تخطي تحميل الموارد الخارجية بشكل افتراضي، مع قائمة بيضاء من المواقع الموثوقة ومعالج لكل مورد
  • [Bug] إصلاح NullReferenceException للوثائق EPUB التي لا يحتوي ملف جدول المحتويات على امتداد .ncx
  • [Bug] إصلاح فشل دمج الصور في تحميل System.ValueTuple في مشاريع .NET Framework باستخدام packages.config
  • [Bug] إصلاح دمج المستندات SVG التي تفشل على إصدارات .NET Framework 4.6.2 إلى 4.7.0
  • [Bug] عرض صفحات EPUB ذات التخطيط الثابت صفحة واحدة لكل صفحة كتاب بدلاً من تقسيم كل منها إلى صفحتين
  • [Bug] تحديث System.Security.Cryptography.Pkcs إلى 8.0.2 و 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] الحفاظ على تنسيق PDF الأصلي والعنوان عند الحفظ مع تمكين العلامة التلقائية
  • [Bug] إصلاح ArgumentException عند تحميل مستندات TeX بشكل متزامن
  • [Bug] حفظ مخرجات LowCode التي تم إعطاؤها كاسم ملف بسيط إلى الدليل الحالي ورفض المستندات المدمجة ذات الصيغة الأخرى
  • [Bug] إصلاح فشل مستندات EPUB بشكل متقطع مع NullReferenceException أو IndexOutOfRangeException عند معالجتها بشكل متزامن

تغييرات API العامة

1. الموارد الخارجية — مرفوضة بشكل افتراضي (API جديد، غير متوافق مع الإصدارات السابقة)

أنواع عامة جديدة في مساحة الاسم GroupDocs.Merger.Domain.Options:

النوع الوصف
IResourceLoadingOptions يحدد SkipExternalResources و WhitelistedResources و ExternalResourceHandler. LoadOptions تنفذه.
IExternalResourceHandler يتم استدعاء طريقة OnLoading الخاصة به لكل مورد خارجي قبل تحميله ويمكنها السماح أو التخطي أو استبداله.
ExternalResourceLoadingArgs المورد الممرّر إلى OnLoading: Uri، Skipped (محدد مسبقًا بناءً على قرار الخيارين الآخرين) و Data (المحتوى لاستخدامه بدلاً من تحميل المورد).

خصائص جديدة لـ LoadOptions:

  • SkipExternalResources — true بشكل افتراضي في كل مُنشئ. بينما تكون true، لا يتم تحميل أي مورد خارجي باستثناء تلك التي تطابق WhitelistedResources أو المسموح بها بواسطة المعالج.
  • WhitelistedResources — بادئات URI مطلقة للموارد التي يتم تحميلها بينما SkipExternalResources هي true، على سبيل المثال https://cdn.example.com/assets/ أو file:///C:/assets/. فارغة بشكل افتراضي.
  • ExternalResourceHandler — null بشكل افتراضي.

تغييرات غير متوافقة مع الإصدارات السابقة:

  • الموارد الخارجية لم تعد تُحمَّل بشكل افتراضي. يتم تخطي الموارد البعيدة (http، https، ftp وغيرها)، مسارات UNC، الملفات المحلية، بما في ذلك الملفات في مجلد المستند نفسه، والإشارات النسبية التي تشير إلى خارج المستند، وتستمر العملية. كانت الإصدارات السابقة تُحمِّلها. لذلك قد تكون الصور والأنماط البعيدة في مستندات HTML وWord والعروض التقديمية مفقودة من المخرجات، وقد يتغير عدد صفحات مستندات HTML وWord. لا يزال يتم تحميل المحتوى الذي يحمل المستند — عناوين data:، إشارات cid:، أجزاء MHTML والوسائط المعبأة. لتحميل الموارد الخارجية، أضف مواقعها إلى القائمة البيضاء، أو اضبط SkipExternalResources إلى false للمستندات التي تثق بها.
  • LoadOptions الآن sealed. لا يمكن الآن تجميع فئة مشتقة منها. استخدم LoadOptions مباشرة، أو نفّذ ILoadOptions؛ تنفيذ مخصص لـ ILoadOptions لا ينفّذ أيضًا IResourceLoadingOptions يحصل على السياسة الافتراضية.
  • إدخال WhitelistedResources يكون null أو فارغًا أو ليس URI مطلقًا أو يحتوي على استعلام أو ش fragment، أو يحتوي على %2F أو %5C أو %2E يجعل مُنشئ Merger يرمي ArgumentException (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).
  • إذا رمى المعالج استثناءً، يتم تخطي المورد وتُرمي العملية GroupDocsMergerException (“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) مع استثناء المعالج كـ InnerException.
  • الآن يتم فحص علامات EPUB، ومستندات SVG وSVGZ في بعض العمليات للعثور على مراجع خارجية. المستند الذي لا تكون علاماته XML صالحة يفشل بـ GroupDocsMergerException (“The document’s markup could not be read to check it for external resources, so it was not loaded. Set SkipExternalResources to false without an ExternalResourceHandler to load it without the check.”).
  • مُنشئات OleDiagramOptions وOleSpreadsheetOptions وOleWordProcessingOptions التي تستقبل مسار ملف ورقم صفحة تُظهر صورة الكائن المضمّن مع رفض الموارد الخارجية، بغض النظر عما تسمح به LoadOptions للمستند الهدف. لعرضها، مرّر بيانات الصورة الخاصة بك إلى المُنشئ الذي يستقبلها.
  • منتجات حزمة GroupDocs.Merger.LowCode دائمًا ما ترفض الموارد الخارجية.

يتم قراءة الخيارات عند إنشاء Merger، وتلتزم المستندات المدمجة به بهذه الخيارات.

2. مستندات PDF ذات العلامة التلقائية تحتفظ بالتنسيق والعنوان للمصدر

لا تغيير في API. مستند PDF يُحفظ باستخدام PdfSaveOptions.AccesibilitySettings.EnableAutoTagging مضبوطًا على true يحتفظ بتنسيق PDF وعنوان المصدر. سابقًا كان كل مستند مُعلَّم تلقائيًا يُصنَّف كـ PDF/UA-1، وكان المصدر غير المعنون يحصل على العنوان “Tagged PDF”. تضيف العلامة التلقائية شجرة هيكل منطقية؛ لا تجعل المستند متوافقًا مع PDF/UA، والمصدر الذي تم تعيينه مسبقًا كـ PDF/UA يحتفظ بعلامته.

3. مستندات EPUB ذات التخطيط الثابت — صفحة واحدة لكل صفحة كتاب

لا تغيير في API. الآن يحتوي مستند EPUB ذو التخطيط الثابت على صفحة واحدة لكل صفحة كتاب. سابقًا كان كل صفحة كتاب تُعرض كصفحتين، لذا كان GetDocumentInfo يُظهر عدد صفحات مضاعف ولم تتطابق الصفحة N مع صفحة الكتاب N. أرقام الصفحات التي تُمرَّر إلى عمليات الصفحات مثل ExtractPages، RemovePages أو Split تشير الآن إلى صفحات الكتاب.

4. GroupDocs.Merger.LowCode — مسار الإخراج والمستندات المدمجة

  • JoinPdf، JoinDocx، JoinPptx وRemovePagesPdf يحلون مسار إخراج نسبي بالنسبة إلى دليل العمل الحالي. الآن يُحفظ مسار الإخراج المقدم كاسم ملف بسيط إلى الدليل الحالي؛ سابقًا كان يُحفظ إلى دليل الإخراج الافتراضي لـ Merger. مسار إخراج null أو فارغ يرمي ArgumentNullException.
  • JoinPdf، JoinDocx وJoinPptx يرميان FileTypeNotSupportedException عندما لا يتطابق امتداد المستند المدمج مع صيغة المنتج، قبل كتابة أي إخراج، على سبيل المثال “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. سابقًا كان JoinPdf وJoinDocx ينتجان مخرجات مختلطة وJoinPptx يفشل لاحقًا برسالة أخرى. مسار مستند مدمج null أو فارغ يرمي ArgumentNullException (“The document at index 0 is null or empty.”).
  • جميع المنتجات السبعة ترمي FileTypeNotSupportedException (“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) لمسار مصدر بدون امتداد، بدلاً من ArgumentException.

5. التبعيات

  • حزم وقت التشغيل تعتمد على System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60، GroupDocs.Merger.Net80 وحزم .Windows الخاصة به) أو 9.0.21 (GroupDocs.Merger.Net100 و GroupDocs.Merger.Net100.Windows). كما تعتمد GroupDocs.Merger.Net60، GroupDocs.Merger.Net60.Windows وGroupDocs.Merger.LowCode على System.Formats.Asn1 8.0.2، وGroupDocs.Merger.LowCode على System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 لم يتغير.
  • في مشاريع .NET Framework، حزمة GroupDocs.Merger لم تعد تضيف إعادة توجيه ربط لـ System.ValueTuple إلى app.config أو web.config (مشاريع packages.config)، وتعيّن أهداف بناء .NET Framework الخاص بها DependsOnNETStandard إلى true ما لم يحدد المشروع ذلك.

الميزات الجديدة

  • Control of external resources: لم تعد الصور البعيدة، الأنماط، الصور المرتبطة والملفات الأخرى التي يشير إليها المستند تُحمَّل ما لم تسمح بذلك. يحتوي LoadOptions على خصائص جديدة SkipExternalResources وWhitelistedResources وExternalResourceHandler للسماح بالمواقع الموثوقة، أو السماح بكل شيء للمستندات التي تثق بها، أو اتخاذ قرار التخطي أو توفير كل مورد في كودك الخاص.
  • Concurrency fixes: لم تعد مستندات EPUB تفشل بشكل متقطع مع NullReferenceException أو IndexOutOfRangeException، ولم تعد مستندات TeX تفشل مع ArgumentException عندما تُعالج من عدة خيوط.
  • EPUB documents: الآن تحتوي مستندات EPUB ذات التخطيط الثابت على صفحة واحدة لكل صفحة كتاب، لذا الصفحة N هي صفحة الكتاب N. لم تعد مستندات EPUB التي يكون ملف جدول محتوياتها بامتداد غير .ncx تفشل مع NullReferenceException.
  • Auto-tagged PDF output: مستند PDF يُحفظ مع العلامة التلقائية يحتفظ بالتنسيق والعنوان للمصدر. لم يعد يُصنَّف كـ PDF/UA-1 ما لم يكن المصدر كذلك، ولا يحصل المصدر غير المعنون على العنوان “Tagged PDF”.
  • .NET Framework projects: لم تعد عمليات دمج الصور في مشاريع packages.config تفشل في تحميل System.ValueTuple، ولم تعد عمليات دمج مستندات SVG تفشل في تحميل netstandard على إصدارات .NET Framework من 4.6.2 إلى 4.7.0.
  • Patched dependency: الحزم تعتمد على System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 و .NET 8.0) أو 9.0.21 (.NET 10.0)، الإصدارات التي تصلح CVE-2026-84008 و CVE-2026-70162.
  • LowCode products: يُحفظ مسار الإخراج المقدم كاسم ملف بسيط إلى الدليل الحالي، وتُرفض JoinPdf وJoinDocx وJoinPptx مستندًا مدمجًا بصيغة مختلفة قبل كتابة أي إخراج.

مثال على الكود

using System.Collections.Generic;
using GroupDocs.Merger;
using GroupDocs.Merger.Domain;
using GroupDocs.Merger.Domain.Options;

var loadOptions = new LoadOptions(FileType.HTML)
{
    // Load resources from one trusted folder only; everything else stays denied
    WhitelistedResources = new List<string> { "https://cdn.example.com/assets/" }
};

using (var merger = new Merger("page1.html", loadOptions))
{
    merger.Join("page2.html");
    merger.Save("merged.html");
}
using System;
using GroupDocs.Merger.Domain.Options;

public class TrustedPngHandler : IExternalResourceHandler
{
    public void OnLoading(ExternalResourceLoadingArgs args)
    {
        Uri uri;
        if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
            && uri.Scheme == Uri.UriSchemeHttps
            && uri.Host == "cdn.example.com"
            && uri.AbsolutePath.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
        {
            args.Skipped = false;   // allow; any other resource keeps the default decision
        }
    }
}

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

NuGet

قم بالترقية إلى أحدث حزمة GroupDocs.Merger عبر NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

تحميل مباشر

حمّل التجميعات من صفحة GroupDocs.Merger for .NET 26.10 .

الموارد