نحن سعداء بالإعلان عن إصدار GroupDocs.Conversion for .NET v26.9، المتاح اعتبارًا من سبتمبر 2026. يقدم هذا الإصدار دعمًا لتنسيقات GIS وضغط جديدة، ويتيح تحويل العروض التقديمية إلى عروض شرائح HTML ذاتية الاحتواء، ويحسن معالجة ملفات TIFF متعددة الصفحات، ويفرض حدًا قدره 10 تحويلات في وضع التقييم لكل عملية. كما يزيل أعضاء API غير المستخدمين ويطبق تحققًا أكثر صرامة للخيارات المتضاربة.
ما الجديد في هذا الإصدار
- [Feature] إضافة WIM كمصدر تحويل للوثائق المضغوطة (CONVERSIONNET-8488)
- [Feature] إضافة Apple Archive (AAR) كمصدر وهدف تحويل للوثائق المضغوطة (CONVERSIONNET-8491)
- [Feature] إضافة ALZ كمصدر تحويل للوثائق المضغوطة (CONVERSIONNET-8494)
- [Feature] إضافة GeoJSON Text Sequence كمصدر تحويل للوثائق GIS (CONVERSIONNET-8508)
- [Feature] إضافة KMZ كمصدر تحويل للوثائق GIS (CONVERSIONNET-8510)
- [Feature] إضافة دعم تحويل GIS إلى إطار العمل الهدف net462 (CONVERSIONNET-8511)
- [Feature] إضافة GML و OSM XML كأهداف تحويل للوثائق GIS (CONVERSIONNET-8512)
- [Feature] تحويل عرض تقديمي إلى عرض شرائح HTML ذاتي الاحتواء (CONVERSIONNET-8529)
- [Improvement] تطبيق حجم الصفحة ودقة كل إطار عند تحويل TIFF متعدد الصفحات إلى PDF (CONVERSIONNET-8519)
- [Improvement] تطبيق حجم الصفحة ودقة الإطار عند تحويل TIFF متعدد الصفحات صفحةً بصفحة (CONVERSIONNET-8520)
- [Improvement] تطبيق حجم الصفحة ودقة كل إطار عند تحويل TIFF متعدد الصفحات إلى PDF مع علامات (CONVERSIONNET-8521)
- [Improvement] تحديد حد وضع التقييم إلى 10 تحويلات لكل عملية (CONVERSIONNET-8523)
- [Improvement] إزالة مستمع المحول القديم، ومراحل المعالج السلس، وخصائص حجم الصفحة (CONVERSIONNET-8561)
- [Bug] PPTX إلى PDF: الخط المزدوج والضربة المزدوجة ينتجان إحداثيات NaN على Linux (CONVERSIONNET-8388)
- [Bug] فشل تحويل PDF بأكثر من 4 صفحات في وضع التقييم (CONVERSIONNET-8515)
- [Bug] عدم تطبيق حد الصفحات التجريبية عند تحويل PDF إلى Web (CONVERSIONNET-8516)
- [Bug] إرجاع عدد الصفحات الصحيح لملف TIFF متعدد الصفحات (CONVERSIONNET-8522)
تغييرات API العامة
تغييرات كاسرة
الأعضاء الذين تم وضع علامة obsolete عليهم في الإصدارات السابقة تم إزالتهم:
| تمت الإزالة | البديل |
|---|---|
IConverterListener و ConverterSettings.Listener |
ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted |
ConverterSettings.OnConversionFailed |
ConversionEvents.OnDocumentFailed |
ConverterSettings.OnConversionByPageFailed |
ConversionEvents.OnPageFailed |
ConverterSettings.OnCompressionCompleted |
ConversionEvents.OnCompressionCompleted |
Fluent .OnCompressionCompleted(...) بعد .Compress(...) (IConversionCompressResultCompleted) |
FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...) |
الواجهات السلسة IConversionHandlerSetup، IConversionHandlerFailed، IConversionHandlerCompleted |
IConversionHandlersStage |
الواجهات السلسة IConversionByPageHandlerSetup، IConversionByPageHandlerFailed، IConversionByPageHandlerCompleted |
IConversionByPageHandlersStage |
CadConvertOptions.PageSize / PageWidth / PageHeight |
CadConvertOptions.SizeSettings (PageSizeOptions) |
EBookConvertOptions.PageSize / PageWidth / PageHeight |
EBookConvertOptions.SizeSettings (PageSizeOptions) |
في API السلس، WithOptions(...) الآن تُعيد IConversionHandlersStage (أو IConversionByPageHandlersStage للتحويل صفحةً بصفحة). الاستدعاءات المتسلسلة مثل .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() لا تزال تُترجم دون تغيير.
يتم الآن تعيين حجم الصفحة فقط عبر SizeSettings:
var options = new CadConvertOptions
{
SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};
حد التحويل في وضع التقييم
بدون ترخيص صالح، يمكن للعملية تنفيذ ما لا يزيد عن 10 تحويلات. كل استدعاء لـ Converter.Convert(...) يُحسب كتحويل واحد — أي نسخة overload، API السلس، أو الاستدعاءات التي تفشل — بغض النظر عن عدد ملفات الإخراج التي ينتجها. لا تُحسب Converter.GetDocumentInfo() ولا Converter.IsDocumentPasswordProtected(). ينتمي العد إلى العملية الجارية؛ إعادة تشغيل التطبيق تُعيد العد من الصفر. بمجرد تطبيق ترخيص صالح، لا تُحسب التحويلات ولا يُطبق الحد.
التحويل الـ 11 يُطلق استثناء EvaluationLimitReachedException (مشتق من GroupDocsConversionException) بالرسالة:
أنت تستخدم GroupDocs.Conversion في وضع التقييم: تم الوصول إلى حد 10 مستندات محولة لكل عملية. احصل على ترخيص مؤقت مجاني لمدة 30 يومًا لإزالة جميع حدود التقييم: https://purchase.groupdocs.com/temporary-license/
قم بتطبيق License أو مفتاح Metered قبل أول تحويل لإزالة الحد:
License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
الكود الذي يعمل بدون ترخيص يمكنه معالجة الحد:
try
{
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
}
catch (EvaluationLimitReachedException ex)
{
Console.WriteLine(ex.Message);
}
إخراج عرض الشرائح لتحويل العروض التقديمية إلى HTML
الخاصية الجديدة WebConvertOptions.SlideShow (القيمة الافتراضية false) تُحول عرضًا تقديميًا — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP أو FODP — إلى ملف HTML واحد ذاتي الاحتواء (Html أو Htm) يُعرض كعرض شرائح. التحويلات الحالية لا تتغير ما لم يتم تعيين SlideShow إلى true.
using (Converter converter = new Converter("presentation.pptx"))
{
WebConvertOptions options = new WebConvertOptions { SlideShow = true };
converter.Convert("slideshow.html", options);
}
مع SlideShow = true، الخيارات المتضاربة تُطلق استثناء InvalidConvertOptionsException قبل بدء التحويل:
| الخيار | الرسالة |
|---|---|
UsePdf = true |
WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow. |
Format هو MHT أو MHTML |
WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (أو mhtml) |
Watermark مُحدد |
WebConvertOptions.SlideShow does not support watermarks. |
Zoom غير 100 |
WebConvertOptions.SlideShow does not support Zoom. |
العرض الشرائحي هو مستند واحد قابل للتنقل، لذا فإن overloads Convert التي تحول صفحةً بصفحة تُطلق System.NotSupportedException بالرسالة Saving a presentation slideshow page by page is not supported.
أنواع الملفات الجديدة
| النوع | الأعضاء الجدد |
|---|---|
CompressionFileType |
Aar, Alz, Wim |
GisFileType |
GeoJsonSeq, Kmz |
| معلومات المستند | AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — كل منها يُظهر شجرة محتوى الأرشيف ContentTree |
مثال على تحويل ZIP إلى Apple Archive:
using (Converter converter = new Converter("assets.zip"))
{
CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
converter.Convert("assets.aar", options);
}
كيفية الحصول على التحديث
NuGet
قم بترقية حزمة GroupDocs.Conversion إلى أحدث إصدار عبر NuGet: GroupDocs.Conversion 26.9.0
dotnet add package GroupDocs.Conversion --version 26.9.0
تنزيل مباشر
حمّل التجميعات من صفحة GroupDocs.Conversion for .NET 26.9