GroupDocs.Conversion برای .NET 26.9 – نکات برجسته انتشار سپتامبر 2026

We’re happy to announce the release of GroupDocs.Conversion for .NET v26.9, available as of September 2026. This release introduces support for new GIS and compression formats, enables conversion of presentations to self‑contained HTML slideshows, improves multi‑page TIFF handling, and enforces a 10‑conversion evaluation limit per process. It also removes obsolete API members and applies stricter validation for conflicting options.

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

[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] محدود کردن حالت ارزیابی به ۱۰ تبدیل در هر فرآیند (CONVERSIONNET-8523)
[Improvement] حذف شنوندهٔ مبدل منسوخ‌شده، مراحل هندلر Fluent و ویژگی‌های اندازه صفحه (CONVERSIONNET-8561)
[Bug] PPTX به PDF: زیرخط دوگانه و خط‌خوردهٔ دوگانه در لینوکس مختصات NaN تولید می‌کنند (CONVERSIONNET-8388)
[Bug] تبدیل PDF با بیش از ۴ صفحه در حالت ارزیابی شکست می‌خورد (CONVERSIONNET-8515)
[Bug] محدودیت صفحات آزمایشی هنگام تبدیل PDF به Web اعمال نمی‌شود (CONVERSIONNET-8516)
[Bug] بازگرداندن تعداد صفحات صحیح برای TIFF چندصفحه‌ای (CONVERSIONNET-8522)

تغییرات API عمومی

تغییرات شکسته‌کننده

عضوهایی که در نسخه‌های قبلی به عنوان منسوخ علامت‌گذاری شده بودند، حذف شدند:

حذف شده	جایگزین
`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 = ...)`
رابط‌های Fluent `IConversionHandlerSetup`, `IConversionHandlerFailed`, `IConversionHandlerCompleted`	`IConversionHandlersStage`
رابط‌های Fluent `IConversionByPageHandlerSetup`, `IConversionByPageHandlerFailed`, `IConversionByPageHandlerCompleted`	`IConversionByPageHandlersStage`
`CadConvertOptions.PageSize` / `PageWidth` / `PageHeight`	`CadConvertOptions.SizeSettings` (`PageSizeOptions`)
`EBookConvertOptions.PageSize` / `PageWidth` / `PageHeight`	`EBookConvertOptions.SizeSettings` (`PageSizeOptions`)

در API Fluent، WithOptions(...) اکنون IConversionHandlersStage (یا IConversionByPageHandlersStage برای تبدیل صفحه به صفحه) را برمی‌گرداند. زنجیرهٔ فراخوانی‌هایی مانند .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() بدون تغییر کامپایل می‌شوند.

اندازه صفحه اکنون فقط از طریق SizeSettings تنظیم می‌شود:

var options = new CadConvertOptions
{
    SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};

محدودیت تبدیل در حالت ارزیابی

بدون داشتن لایسنس معتبر، یک فرآیند حداکثر می‌تواند ۱۰ تبدیل انجام دهد. هر فراخوانی به Converter.Convert(...) به عنوان یک تبدیل حساب می‌شود — هر overload، API Fluent و حتی فراخوانی‌های ناموفق — صرف‌نظر از تعداد فایل‌های خروجی تولید شده. Converter.GetDocumentInfo() و Converter.IsDocumentPasswordProtected() شمارش نمی‌شوند. شمارش به فرآیند جاری تعلق دارد؛ راه‌اندازی مجدد برنامه شمارش را از نو آغاز می‌کند. پس از اعمال لایسنس معتبر، تبدیل‌ها دیگر شمارش یا محدود نمی‌شوند.

تبدیل یازدهم یک استثنای EvaluationLimitReachedException (مشتق از GroupDocsConversionException) با پیام زیر پرتاب می‌کند:

You are using GroupDocs.Conversion in evaluation mode: the limit of 10 documents converted per process has been reached. Get a free 30-day temporary license to remove all evaluation limits: 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.`

یک اسلایدشو یک سند قابل مرور است، بنابراین overloadهای 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 دریافت کنید

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

تغییرات API عمومی#

تغییرات شکسته‌کننده#

محدودیت تبدیل در حالت ارزیابی#

خروجی اسلایدشو برای تبدیل ارائه به HTML#

انواع فایل جدید#

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

NuGet#

دانلود مستقیم#

منابع#