אנחנו שמחים להודיע על שחרור 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 slideshow עצמאי (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 בלינוקס (CONVERSIONNET-8388)
- [Bug] המרת PDF עם יותר מ‑4 דפים נכשלת במצב הערכה (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 השוטף, WithOptions(...) מחזיר כעת IConversionHandlersStage (או IConversionByPageHandlersStage עבור המרה דף‑אחר‑דף). קריאות משולבות כגון .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() נותרות תקינות.
גודל הדף מוגדר כעת רק דרך SizeSettings:
var options = new CadConvertOptions
{
SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};
מגבלת המרות במצב הערכה
ללא רישיון תקף, תהליך יכול לבצע לכל היותר 10 המרות. כל קריאה ל‑Converter.Convert(...) נחשבת כהמרה אחת — כולל כל עומס יתר, ה‑API השוטף, וקריאות שנכשלות — ללא קשר למספר קבצי הפלט שנוצרים. Converter.GetDocumentInfo() ו‑Converter.IsDocumentPasswordProtected() אינן נספרות. הספירה שייכת לתהליך הרץ; הפעלה מחדש של היישום מאפסת אותה. לאחר החלת רישיון תקף, ההמרות אינן נספרות יותר ולא מוגבלות.
ההמרה ה‑11 גורמת לזריקת EvaluationLimitReachedException (נגזרת של GroupDocsConversionException) עם ההודעה:
אתה משתמש ב‑GroupDocs.Conversion במצב הערכה: הושגה מגבלת 10 מסמכים שהומרו לכל תהליך. קבל רישיון זמני חינמי ל‑30 יום כדי להסיר את כל מגבלות ההערכה: https://purchase.groupdocs.com/temporary-license/
החל [License](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/license/) או מפתח [Metered](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/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. המרות קיימות אינן משתנות אלא אם כן SlideShow מוגדר ל‑true.
using (Converter converter = new Converter("presentation.pptx"))
{
WebConvertOptions options = new WebConvertOptions { SlideShow = true };
converter.Convert("slideshow.html", options);
}
כאשר SlideShow = true, אופציות סותרות גורמות לזריקת InvalidConvertOptionsException לפני תחילת ההמרה:
| Option | Message |
|---|---|
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. |
שקופית היא מסמך נוויגבילי יחיד, ולכן עומסי 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