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