GroupDocs.Annotation for .NET 26.10 – הדגשי המהדורה של אוקטובר 2026

אנחנו שמחים להודיע על GroupDocs.Annotation for .NET 26.10, שוחרר באוקטובר 2026. זוהי גרסה המתמקדת באבטחה: המסמכים כבר אינם מושכים תמונות מרוחקות, גיליונות סגנון או קבצים מקושרים באופן אוטומטי, וחברי LoadOptions החדשים מאפשרים לכם להחליט בדיוק מה ניתן לטעון. הגרסה גם משדרגת את מנועי המסמכים הבסיסיים, מעדכנת תלות פגיעה ומתקנת מספר בעיות.

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

משאבים חיצוניים אינם נטענים כברירת מחדל

מסמך יכול להתייחס למשאבים מחוץ לו: <img src="https://..."> בדף HTML או בגוף אימייל, תמונה מקושרת במסמך Word, גיליון סגנון מרוחק או קישור חיצוני לגיליון עבודה. עד כה, פתיחה, תצוגה מקדימה או שמירה של מסמך כזה גרמה ל‑GroupDocs.Annotation לבקש את המשאבים מהרשת או משיתוף קבצים.

בשרת שמעבד מסמכים לא מהימנים, זהו סיכון של התחזות בקשת צד שרת (SSRF): מסמך יכול לגרום לשרת לבצע קריאות לכתובות פנימיות, ונתיב UNC יכול לדלוף את אישורי ה‑Windows של התהליך.

החל מ‑26.10, משאבים חיצוניים מדולגים כברירת מחדל עבור מסמכי עיבוד תמלילים, HTML, אימייל, מצגות וגיליונות אלקטרוניים:

• אין בקשות. לא מתבצעת בקשת רשת או שיתוף קבצים עבור משאבים שהמסמך מתייחס אליהם, בכל פעולה: Get, Add, Save, GeneratePreview ו‑GetDocumentInfo.
• מקומות שמורים ריקים. תמונה מדולגת מוצגת כמקום שמור שקוף, והקישור המקורי נשמר במסמך השמור.
• תוכן משובץ עדיין פועל. חלקי cid: של אימייל, כתובות data: ותמונות משובצות נטענים תמיד.
• הערות תמונה אינן מושפעות. ImageAnnotation.ImagePath עדיין נטען מכתובת URL.

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

אפשר רק מארחים מהימנים (מומלץ):

LoadOptions loadOptions = new LoadOptions
{
    // SkipExternalResources stays true (the default)
    WhitelistedResources = { "cdn.example.com", "https://intranet.example.com/images/" }
};

using (Annotator annotator = new Annotator("input.html", loadOptions))
{
    annotator.Save("output.html"); // only images from the two whitelisted locations are loaded
}

בדקו, אפשרו או החליפו כל משאב באמצעות מטפל:

class AuditingResourceHandler : ExternalResourceHandler
{
    public override void OnLoading(ExternalResourceLoadingArgs args)
    {
        Console.WriteLine($"{args.Uri}: {(args.Skipped ? "skipped" : "loaded")}");

        // serve a local copy instead of going to the network
        if (args.Uri == "https://example.com/logo.png")
            args.Data = File.ReadAllBytes("logo.png");
    }
}

מנועי מסמכים משודרגים

המנועים המוטמעים לעיבוד תמלילים, גיליונות, מצגות, PDF, דיאגרמות, אימייל, עיבוד תמונה, CAD והצגת גרפיקה עודכנו לגרסאות של אוקטובר 2026. מסמכים ותצוגות מקדימות של דפים שנוצרים מחדש עשויים להשתנות במקצת ברמת הבייט או הפיקסל בעוד שהם נשארים שווים מבחינה ויזואלית.

עבור פרויקטים ב‑.NET 6 ו‑.NET 8, חבילות זמן הריצה תלויות כעת ב‑SkiaSharp 4.152.1. אם הפרויקט שלכם מתייחס ישירות ל‑SkiaSharp 3.x, עדכנו אותו ל‑4.x.

עדכון אבטחה

מנועי המסמכים כוללים את System.Security.Cryptography.Pkcs גרסאות 8.0.0 או 8.0.1, שהן מושפעות מ‑CVE-2026-84008 ו‑CVE-2026-70162. GroupDocs.Annotation כעת מתייחס לגרסה המתוקנת 8.0.2 בכל מסגרת יעד. אין צורך בשינויים בקוד.

תיקונים

• EML מזרם. הודעת EML שמתחילה ב‑MIME-Version: 1.0 זוהתה כקובץ ארכיון MHT, ופתיחתה מזרם גרמה ל‑FileTypeNotSupportedException. הודעות כאלה נפתחות כעת באותו אופן מזרם וקובץ, ו‑קבצי MHT נתמכים כעת כמסמכי אימייל.
• מסמכים ישנים ב‑.NET 8. מסמכים שהוערכו בגרסאות לפני 26.6 נכשלו בפתיחה ב‑.NET 8 עם NotSupportedException. הם נפתחים כעת: ההערות הישנות מדולגות עם אזהרת לוג, וניתן להוסיף ולשמור הערות חדשות. בעיה קשורה עם מצגות שנשמרו מחדש (PPTX) שהערותיהן לא ניתנות לקריאה תוקנה בכל המסגרות.
• סיבוב PDF ב‑90 מעלות. סיבוב דף PDF באמצעות Annotator.Rotation עבד עבור 180 ו‑270 מעלות, אך סיבוב של 90 מעלות אבד בעת שמירה. הוא נשמר כעת לכל זווית:

using (Annotator annotator = new Annotator("input.pdf"))
{
    annotator.ProcessPages = 1;                 // the page to rotate
    annotator.Rotation = RotationDocument.on90; // previously ignored
    annotator.Save("output.pdf");
}

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

הגרסה מוסיפה את החברים הבאים:

• LoadOptions.SkipExternalResources
• LoadOptions.WhitelistedResources
• LoadOptions.ExternalResourceHandler
• ExternalResourceHandler class
• ExternalResourceLoadingArgs class

לא הוסרו או שונו חברים ציבוריים.

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

NuGet

התקינו או עדכנו ל‑GroupDocs.Annotation 26.10.0 באמצעות NuGet. החבילה פותרת אוטומטית את חבילת זמן הריצה עבור מסגרת היעד שלכם (.NET Framework 4.6.2, .NET 6 או .NET 8):

dotnet add package GroupDocs.Annotation --version 26.10.0

הורדה ישירה

הורידו את הגרסה מהדף GroupDocs.Annotation for .NET 26.10 .

משאבים

• הערות שחרור מלאות
• תיעוד
• הפניות API
• דוגמאות ב‑GitHub
• Free Support Forum