GroupDocs.Conversion for .NET 26.8 – נקודות מרכזיות של המהדורה באוגוסט 2026

מה חדש בגרסה זו

שינויים בממשק API ציבורי

⚠️ שינויים לא תואמים לאחור – העדכונים הבאים משנים התנהגות ציבורית קיימת. יש להתאים את הקוד שלכם כדי למנוע שגיאות בזמן ריצה.

1. LoadOptions.Format מחזיר null במקום לזרוק חריגה כאשר הפורמט אינו מוגדר

מחלקות מושפעות: כל 28 אפשרויות טעינה טיפוסיות (למשל, SpreadsheetLoadOptions, PdfLoadOptions, CadLoadOptions, …)

מה השתנה
קריאת המאפיין Format לפני שהוגדר פורמט גרמה בעבר לחריגה. כעת היא מחזירה null, מה שמאפשר בדיקת null פשוטה.

דוגמת הגירה

var loadOptions = new SpreadsheetLoadOptions();

if (loadOptions.Format == null)
{
    // נתיב קוד חדש – בעבר היה בלתי נגיש מכיוון שה‑getter זרק חריגה.
}

הכוונה
החליפו כל try/catch סביב loadOptions.Format בבדיקה של null. אל תבצעו השוואה ל‑FileType.Unknown; הבדיקה הנכונה היא == null.

2. אימות התאמה מדויקת עבור CadLoadOptions.LayoutNames עם דיווח שגיאות מפורט

מחלקה מושפעת: CadLoadOptions

מה השתנה
LayoutNames מתאימים כעת בדיוק (רגישות לרישיות) לשמות הפריסות של השרטוט. אם אף שם אינו תואם, ההמרה נכשלת עם InvalidLoadOptionsException שמפרט את הפריסות הזמינות ואת הבקשה הלא תואמת.

דוגמת הגירה

using GroupDocs.Conversion.Exceptions;

try
{
    using var converter = new Converter("drawing.dwg",
        ctx => new CadLoadOptions { LayoutNames = new[] { "layout1" } });
    converter.Convert("out.pdf", new PdfConvertOptions());
}
catch (InvalidLoadOptionsException ex)
{
    // דוגמת הודעה:
    // "No layout name in CadLoadOptions.LayoutNames matches this drawing, which carries
    //  Model, Layout1, Layout2. Requested: layout1. Names are matched exactly, so a name
    //  that differs only in case is a different name."
    Console.WriteLine(ex.Message);
}

הכוונה

• ודאו שהשמות של הפריסות מאויתים נכון ותואמים בדיוק למקרה של האותיות במקור.
• כאשר נדרשת רק תת‑קבוצה של פריסות, ספקו את השמות המדויקים; ערכים שאינם תואמים יזוזו, והפריסות המתאימות עדיין יומרו.

3. שרטוטי CAD מרובי‑גיליון מייצרים כעת יחידת פלט אחת לכל גיליון

מחלקות מושפעות: Converter, PresentationConvertOptions, PdfConvertOptions

מה השתנה
בעבר, המרת שרטוט עם מספר פריסות מרחב‑נייר יצרה תמונה/שקף משולב יחיד. כעת ההמרה יוצרת יחידות פלט נפרדות (שקפים, דפים וכו’) לכל פריסה, בגודל בהתאם להגדרות העמוד של אותה פריסה. Converter.GetDocumentInfo().PagesCount משקף את מספר היחידות שנוצרו.

דוגמת הגירה – המרה

using var converter = new Converter("multi-layout.dwg");

// שלושה גיליונות נכנסים, שלושה שקפים יוצאים – בעבר היה שקף משולב אחד.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

דוגמת הגירה – קבלת מספר דפים

using var converter = new Converter("multi-layout.dwg");
int sheets = converter.GetDocumentInfo().PagesCount; // מחזיר 3 עבור שלוש פריסות

הכוונה

• עדכנו תהליכים תלו‑תוצאה (למשל, פגינציה בממשק משתמש, שמות קבצים) כדי להתמודד עם קבצים/דפים מרובים.
• עבור שרטוטים עם פריסה אחת ההתנהגות נשארת ללא שינוי.
• החריגה היא CAD → PDF/UA‑1, שממשיך לייצר דף מתויג יחיד.

4. מאפיין חדש CadLoadOptions.LayoutScope לבקר במפורש אילו מרחבים יומרו

מחלקה מושפעת: CadLoadOptions

מה השתנה
LayoutScope מאפשר לציין האם לטעון Model, Layouts, או Both (ברירת מחדל).

• כאשר LayoutNames מוגדר, LayoutScope מתעלם מכיוון שהשמות המפורשים גוברים.
• בחירת תחום שמחזיר אפס גיליונות עבור שרטוט שמכיל לפחות גיליון אחד תגרום ל‑InvalidLoadOptionsException במקום להציג את המרחבים ברירת המחדל בשקט.

דוגמת הגירה – המרה של פריסות מרחב‑נייר בלבד

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

using var converter = new Converter("drawing.dwg",
    ctx => new CadLoadOptions { LayoutScope = CadLayoutScope.Layouts });
converter.Convert("layouts.pdf", new PdfConvertOptions());

הכוונה

• קוד קיים שהסתמך על בחירת ברירת המחדל של המערכת ימשיך לעבוד מכיוון ש‑Both נשאר ברירת המחדל.
• כדי להוציא את מרחב המודל או לכלול רק אותו, הגדירו LayoutScope ל‑CadLayoutScope.Model או CadLayoutScope.Layouts בהתאמה.
• אם בעבר ניסיתם לסנן פריסות על‑ידי מתן מערך ריק ל‑LayoutNames, החליפו תבנית זו בערך מתאים של LayoutScope לקבלת שגיאה ברורה כאשר אין פריסות נבחרות.

תכונות חדשות

בקרת פריסות CAD מתקדמת: בחירת פריסות CAD ספציפיות, המרת כל פריסה לשקף, גיליון עבודה, דף, תמונה או אזור SVG נפרד, ובחירת מרחב מודל, פריסות נייר או שניהם באמצעות CadLayoutScope. זה מספק פלט מדויק לכל פריסה ומכבד הגדרות ייחודיות כגון כיוון וגודל עמוד.

הרחבת תמיכת ארכיונים: פורמטים XAR ו‑CAB זמינים כעת כמקורות ויעדים למסמכי דחיסה, מה שמאפשר המרות חלקות אל ומאל סוגי ארכיונים אלה.

אינטראופרביליות מודרנית של דיאגרמות: קבצי Mermaid MMD ניתנים לשימוש כמקורות דיאגרמה, וקבצי Drawio נתמכים כיעדי המרה, מה שמקל על שילוב כלי דיאגרמה עכשוויים בצינורות ההמרה שלכם.

שיפורי יציבות קריטיים: תוקנו תקלות המרה עבור EML → PDF, קווי מתאר של צורות DOCX, כותרות/תחתיות במצגות וקישורי סיכום פגומים, יצירת תמונות ממוזערות בלינוקס, וטיפול בכיוון גיליון DWG. תיקונים אלה משפרים את האמינות בעבודה עם דוא"ל, מסמכי Office, מצגות ו‑CAD.

דוגמת קוד

using var converter = new Converter("multi-layout.dwg");

// שלושה גיליונות נכנסים, שלושה שקפים יוצאים – בעבר היה שקף משולב אחד.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

איך לקבל את העדכון

NuGet

Install-Package GroupDocs.Conversion -Version 26.8

GroupDocs.Conversion 26.8 on NuGet

הורדה ישירה

לא ניתנו קישורי הורדה ישירה בתיעוד השחרור.

משאבים

• SpreadsheetLoadOptions reference
• PdfLoadOptions reference
• CadLoadOptions reference
• Converter class reference
• PresentationConvertOptions reference
• PdfConvertOptions reference