אנחנו שמחים להודיע על שחרור 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

משאבים