אנחנו שמחים להודיע על השחרור של GroupDocs.Merger for .NET v26.10, זמין החל מ-אוקטובר 2026. גרסה זו מציגה שיפורים משמעותיים בשליטה על טעינת משאבים חיצוניים, פותרת בעיות קונקרנציה קריטיות בעיבוד EPUB ו‑TeX, משפרת פגינציה של EPUB, משמרת את פורמט ה‑PDF ואת הכותרת בפלט עם תיוג אוטומטי, ומתקנת מספר תקלות הקשורות ל‑.NET Framework. בסך הכל, היא כוללת 10 תכונות, שיפורים ותיקוני באגים.

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

  • [תכונה] דלג על טעינת משאבים חיצוניים כברירת מחדל, עם רשימת לבן של מקומות מהימנים ומטפל לכל משאב
  • [באג] תקן NullReferenceException עבור מסמכי EPUB שהקובץ של תוכן העניינים שלהם אינו בעל סיומת .ncx
  • [באג] תקן חיבורי תמונות שנכשלו בטעינת System.ValueTuple בפרויקטים של .NET Framework עם packages.config
  • [באג] תקן חיבורים עם מסמכי SVG שנכשלו בריצות של .NET Framework 4.6.2 עד 4.7.0
  • [באג] הצג דפי EPUB עם פריסה קבועה דף אחד לכל דף ספר במקום לחלק כל אחד לשניים
  • [באג] עדכן את System.Security.Cryptography.Pkcs לגרסאות 8.0.2 ו‑9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [באג] שמור את פורמט ה‑PDF המקורי ואת הכותרת בעת שמירה עם תיוג אוטומטי מופעל
  • [באג] תקן ArgumentException כאשר מסמכי TeX נטענים במקביל
  • [באג] שמור פלט LowCode שניתן כשם קובץ יחיד לתיקייה הנוכחית ודחה מסמכים משולבים בפורמט שונה
  • [באג] תקן מסמכי EPUB שנכשלים לעיתים קרובות עם NullReferenceException או IndexOutOfRangeException כאשר מעובדים במקביל

שינויים ב‑API הציבורי

1. משאבים חיצוניים — נדחים כברירת מחדל (API חדש, לא תואם לאחור)

טיפוסים ציבוריים חדשים במרחב השמות GroupDocs.Merger.Domain.Options:

סוג תיאור
IResourceLoadingOptions מגדיר את SkipExternalResources, WhitelistedResources ו‑ExternalResourceHandler. LoadOptions מממש אותו.
IExternalResourceHandler המתודה OnLoading שלו נקראת עבור כל משאב חיצוני לפני טעינתו ויכולה לאפשר, לדלג או להחליף אותו.
ExternalResourceLoadingArgs המשאב המועבר ל‑OnLoading: Uri, Skipped (קבוע מראש לפי החלטת שתי האפשרויות האחרות) ו‑Data (תוכן לשימוש במקום טעינת המשאב).

מאפיינים חדשים של LoadOptions:

  • SkipExternalResources — true כברירת מחדל בכל בנאי. כאשר true, לא נטען משאב חיצוני אלא אם הוא תואם ל‑WhitelistedResources או מותר על ידי המטפל.
  • WhitelistedResources — קידומות URI מוחלטות של משאבים שנטענים כאשר SkipExternalResources הוא true, לדוגמה https://cdn.example.com/assets/ או file:///C:/assets/. ריק כברירת מחדל.
  • ExternalResourceHandler — null כברירת מחדל.

שינויים לא תואמים לאחור:

  • המשאבים החיצוניים אינם נטענים יותר כברירת מחדל. משאבים מרוחקים (http, https, ftp ו‑פרוטוקולים אחרים), נתיבי UNC, קבצים מקומיים, כולל קבצים בתיקיית המסמך עצמה, והפניות יחסיות שמצביעות מחוץ למסמך מדולגים, והפעולה ממשיכה. גרסאות קודמות טענו אותם. תמונות מרוחקות וגליונות סגנון של מסמכי HTML, Word והצגות עשויים ולכן להיות חסרים בפלט, וספירת העמודים של מסמכי HTML ו‑Word יכולה להשתנות. תוכן שהמסמך נושא — URI‑ים data:, הפניות cid:, חלקי MHTML ומדיה ארוזה — עדיין נטען. כדי לטעון משאבים חיצוניים, הוסף את מיקומיהם לרשימת הלבן, או הגדר SkipExternalResources ל‑false עבור מסמכים שאתה סומך עליהם.
  • LoadOptions הוא כעת sealed. מחלקה שיורשת ממנו לא תקומפל יותר. השתמש ב‑LoadOptions ישירות, או מימוש ILoadOptions; מימוש מותאם של ILoadOptions שאינו מממש גם IResourceLoadingOptions מקבל את המדיניות ברירת המחדל.
  • ערך WhitelistedResources שהוא null, ריק, אינו URI מוחלט, מכיל שאילתה או קטע, או מכיל %2F, %5C או %2E גורם לבנאי Merger לזרוק ArgumentException (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).
  • אם המטפל זורק חריגה, המשאב מדולג והפעולה זורקת GroupDocsMergerException (“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) כאשר החריגה של המטפל משמשת כ‑InnerException.
  • מסמכי EPUB, וכן מסמכי SVG ו‑SVGZ בחלק מהפעולות, כעת נבדקים עבור הפניות חיצוניות. מסמך שהקוד שלו אינו XML תקין נכשל עם GroupDocsMergerException (“The document’s markup could not be read to check it for external resources, so it was not loaded. Set SkipExternalResources to false without an ExternalResourceHandler to load it without the check.”).
  • הבונים של OleDiagramOptions, OleSpreadsheetOptions ו‑OleWordProcessingOptions המקבלים נתיב קובץ ומספר עמוד מציגים את תמונת האובייקט המוטמע עם משאבים חיצוניים נדחים, ללא קשר למה שה‑LoadOptions של המסמך היעד מאפשר. כדי להציגם, העבר את נתוני התמונה שלך לבנאי שמקבל אותם.
  • המוצרים של חבילת GroupDocs.Merger.LowCode תמיד דוחים משאבים חיצוניים.

האפשרויות נקראות בעת יצירת ה‑Merger, והמסמכים שמצורפים אליו פועלים על פי האפשרויות שלו.

2. מסמכי PDF עם תיוג אוטומטי שומרים את הפורמט והכותרת של המקור

אין שינוי ב‑API. מסמך PDF שנשמר עם PdfSaveOptions.AccesibilitySettings.EnableAutoTagging מוגדר ל‑true שומר את פורמט ה‑PDF ואת הכותרת של המקור. בעבר כל מסמך עם תיוג אוטומטי סומן כ‑PDF/UA-1, ומקור ללא כותרת קיבל את הכותרת “Tagged PDF”. תיוג אוטומטי מוסיף עץ מבנה לוגי; הוא אינו הופך את המסמך לתואם PDF/UA, ומקור שכבר מסומן כ‑PDF/UA שומר את הסימון שלו.

3. מסמכי EPUB עם פריסה קבועה — דף אחד לכל דף ספר

אין שינוי ב‑API. מסמך EPUB עם פריסה קבועה כעת מציג דף אחד לכל דף ספר. בעבר כל דף ספר היה מוצג כשני דפים, ולכן GetDocumentInfo דיווח על מספר עמודים כפול והעמוד N לא תאם לעמוד הספר N. מספרי העמודים המועברים לפעולות עמוד כגון ExtractPages, RemovePages או Split מתייחסים כעת לעמודי הספר.

4. GroupDocs.Merger.LowCode — נתיב פלט ומסמכים מצורפים

  • JoinPdf, JoinDocx, JoinPptx ו‑RemovePagesPdf פותרים נתיב פלט יחסי ביחס לתיקיית העבודה הנוכחית. נתיב פלט שניתן כשם קובץ יחיד נשמר כעת לתיקייה הנוכחית; בעבר הוא נשמר לתיקיית הפלט המוגדרת כברירת מחדל של Merger. נתיב פלט null או ריק זורק ArgumentNullException.
  • JoinPdf, JoinDocx ו‑JoinPptx זורקים FileTypeNotSupportedException כאשר סיומת המסמך המצורף אינה תואמת לפורמט של המוצר, לפני שנכתב פלט כלשהו, לדוגמה “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. בעבר JoinPdf ו‑JoinDocx ייצרו פלט מעורב ו‑JoinPptx נכשל מאוחר יותר עם הודעה אחרת. נתיב מסמך מצורף null או ריק זורק ArgumentNullException (“The document at index 0 is null or empty.”).
  • כל שבעת המוצרים זורקים FileTypeNotSupportedException (“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) עבור נתיב מקור ללא סיומת, במקום ArgumentException.

5. תלותים

  • חבילות זמן הריצה תלויות ב‑System.Security.Cryptography.Pkcs גרסה 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 והחבילות .Windows שלהם) או 9.0.21 (GroupDocs.Merger.Net100 ו‑GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows ו‑GroupDocs.Merger.LowCode תלויות גם ב‑System.Formats.Asn1 גרסה 8.0.2, ו‑GroupDocs.Merger.LowCode ב‑System.Security.Cryptography.Pkcs גרסה 8.0.2. GroupDocs.Merger.Net462 אינו משתנה.
  • בפרויקטים של .NET Framework, חבילת GroupDocs.Merger אינה מוסיפה יותר הפנייה (binding redirect) ל‑System.ValueTuple ב‑app.config או web.config (פרויקטים עם packages.config), והיעדים של בניית .NET Framework שלה מגדירים DependsOnNETStandard ל‑true אלא אם הפרויקט מגדיר אחרת.

תכונות חדשות

  • בקרת משאבים חיצוניים: תמונות מרוחקות, גליונות סגנון, תמונות מקושרות וקבצים אחרים שהמסמך מתייחס אליהם אינם נטענים יותר אלא אם תאפשר זאת. ל‑LoadOptions יש מאפיינים חדשים SkipExternalResources, WhitelistedResources ו‑ExternalResourceHandler המאפשרים לאפשר מיקומים מהימנים, לאפשר הכל עבור מסמכים שאתה סומך עליהם, או להחליט, לדלג או לספק כל משאב בקוד שלך.
  • תיקוני קונקרנציה: מסמכי EPUB אינם נכשלים יותר לעיתים קרובות עם NullReferenceException או IndexOutOfRangeException, ומסמכי TeX עם ArgumentException, כאשר הם מעובדים ממספר חוטים.
  • מסמכי EPUB: מסמכי EPUB עם פריסה קבועה כעת מציגים דף אחד לכל דף ספר, כך שהעמוד N הוא דף הספר N. מסמכי EPUB שהקובץ של תוכן העניינים שלהם בעל סיומת שונה מ‑.ncx אינם נכשלים יותר עם NullReferenceException.
  • פלט PDF עם תיוג אוטומטי: מסמך PDF שנשמר עם תיוג אוטומטי שומר את הפורמט ואת הכותרת של המקור. הוא אינו מסומן יותר כ‑PDF/UA-1 אלא אם המקור היה, ומקור ללא כותרת אינו מקבל יותר את הכותרת “Tagged PDF”.
  • פרויקטים של .NET Framework: חיבורים של תמונות בפרויקטים עם packages.config אינם נכשלים יותר בטעינת System.ValueTuple, וחיבורים עם מסמכי SVG אינם נכשלים יותר בטעינת netstandard בריצות של .NET Framework 4.6.2 עד 4.7.0.
  • תלות מתוקנת: החבילות תלויות ב‑System.Security.Cryptography.Pkcs גרסה 8.0.2 (.NET 6.0 ו‑.NET 8.0) או 9.0.21 (.NET 10.0), הגרסאות שמתקנות CVE-2026-84008 ו‑CVE-2026-70162.
  • מוצרים LowCode: נתיב פלט שניתן כשם קובץ יחיד נשמר לתיקייה הנוכחית, ו‑JoinPdf, JoinDocx ו‑JoinPptx דוחים מסמך מצורף בפורמט שונה לפני שנכתב פלט כלשהו.

דוגמת קוד

using System.Collections.Generic;
using GroupDocs.Merger;
using GroupDocs.Merger.Domain;
using GroupDocs.Merger.Domain.Options;

var loadOptions = new LoadOptions(FileType.HTML)
{
    // Load resources from one trusted folder only; everything else stays denied
    WhitelistedResources = new List<string> { "https://cdn.example.com/assets/" }
};

using (var merger = new Merger("page1.html", loadOptions))
{
    merger.Join("page2.html");
    merger.Save("merged.html");
}
using System;
using GroupDocs.Merger.Domain.Options;

public class TrustedPngHandler : IExternalResourceHandler
{
    public void OnLoading(ExternalResourceLoadingArgs args)
    {
        Uri uri;
        if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
            && uri.Scheme == Uri.UriSchemeHttps
            && uri.Host == "cdn.example.com"
            && uri.AbsolutePath.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
        {
            args.Skipped = false;   // allow; any other resource keeps the default decision
        }
    }
}

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

NuGet

שדרג לחבילה האחרונה של GroupDocs.Merger דרך NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

הורדה ישירה

הורד את הקבצים המורכבים מהדף GroupDocs.Merger for .NET 26.10 .

משאבים