نحن سعداء بالإعلان عن إصدار 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 .