เรามีความยินดีที่จะประกาศการเปิดตัว GroupDocs.Merger for .NET v26.10 ซึ่งพร้อมให้ใช้ตั้งแต่ October 2026 รุ่นนี้นำเสนอการปรับปรุงครั้งใหญ่สำหรับการควบคุมการโหลดทรัพยากรภายนอก แก้ไขปัญหาการทำงานพร้อมกันที่สำคัญในกระบวนการ EPUB และ TeX ปรับปรุงการแบ่งหน้า EPUB รักษารูปแบบ PDF และชื่อเรื่องในผลลัพธ์ที่ทำการแท็กอัตโนมัติ และแก้ไขข้อผิดพลาดหลายประการที่เกี่ยวข้องกับ .NET Framework โดยรวมแล้วมีฟีเจอร์ การปรับปรุง และการแก้ไขบั๊กทั้งหมด 10 รายการ

สิ่งใหม่ในรุ่นนี้

  • [Feature] ข้ามการโหลดทรัพยากรภายนอกโดยค่าเริ่มต้น พร้อมรายการไวท์ลิสต์ของตำแหน่งที่เชื่อถือได้และตัวจัดการทรัพยากรต่อรายการ
  • [Bug] แก้ไข NullReferenceException สำหรับเอกสาร EPUB ที่ไฟล์สารบัญไม่มีส่วนขยาย .ncx
  • [Bug] แก้ไขการรวมรูปภาพที่ล้มเหลวในการโหลด System.ValueTuple ในโครงการ .NET Framework ที่ใช้ packages.config
  • [Bug] แก้ไขการรวมไฟล์ SVG ที่ล้มเหลวบน .NET Framework 4.6.2 ถึง 4.7.0 runtimes
  • [Bug] แสดงหน้าตายตัวของ EPUB หนึ่งหน้าต่อหนึ่งหน้าหนังสือแทนการแยกเป็นสองหน้า
  • [Bug] อัปเดต System.Security.Cryptography.Pkcs เป็น 8.0.2 และ 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] รักษารูปแบบ PDF ดั้งเดิมและชื่อเรื่องเมื่อบันทึกด้วยการเปิดใช้งาน auto‑tagging
  • [Bug] แก้ไข ArgumentException เมื่อเอกสาร TeX ถูกโหลดพร้อมกันหลายครั้ง
  • [Bug] บันทึกผลลัพธ์ LowCode ที่ระบุเป็นชื่อไฟล์เปล่าไปยังไดเรกทอรีปัจจุบันและปฏิเสธเอกสารที่รวมที่มีรูปแบบอื่น
  • [Bug] แก้ไขเอกสาร 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 อาจเปลี่ยนแปลงได้ ส่วนเนื้อหาที่เอกสารบรรจุไว้ — data: URIs, cid: references, ส่วนของ MHTML และสื่อที่บรรจุไว้ — ยังคงโหลดได้ หากต้องการโหลดทรัพยากรภายนอก ให้เพิ่มตำแหน่งของพวกมันในไวท์ลิสต์ หรือกำหนด SkipExternalResources เป็น false สำหรับเอกสารที่คุณเชื่อถือ
  • LoadOptions ตอนนี้เป็น sealed คลาสที่สืบทอดจากมันจะไม่คอมไพล์ ใช้ LoadOptions โดยตรง หรือทำการ implement ILoadOptions; การ implement ILoadOptions ที่ไม่ได้ implement IResourceLoadingOptions จะได้รับนโยบายเริ่มต้น
  • รายการ WhitelistedResources ที่เป็น null, ว่าง, ไม่ใช่ URI แบบเต็ม, มี query หรือ fragment, หรือมี %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 ในบางการดำเนินการ, ตอนนี้จะตรวจสอบ markup เพื่อหาการอ้างอิงภายนอก เอกสารที่ markup ไม่เป็น 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 ที่ทำ auto‑tagging จะรักษารูปแบบและชื่อเรื่องของแหล่งที่มา

ไม่มีการเปลี่ยนแปลง API เอกสาร PDF ที่บันทึกด้วย PdfSaveOptions.AccesibilitySettings.EnableAutoTagging ตั้งค่าเป็น true จะรักษารูปแบบ PDF และชื่อเรื่องของแหล่งที่มา ก่อนหน้านี้ทุกเอกสารที่ทำ auto‑tagging จะถูกระบุเป็น PDF/UA-1 และแหล่งที่ไม่มีชื่อเรื่องจะได้ชื่อ “Tagged PDF” การทำ auto‑tagging จะเพิ่มโครงสร้างต้นไม้เชิงตรรกะ แต่ไม่ได้ทำให้เอกสารเป็น PDF/UA compliant, และแหล่งที่ถูกระบุเป็น PDF/UA แล้วจะคงสภาพนั้นไว้

3. เอกสาร EPUB แบบ fixed‑layout — หนึ่งหน้าต่อหนึ่งหน้าหนังสือ

ไม่มีการเปลี่ยนแปลง API เอกสาร EPUB แบบ fixed‑layout ตอนนี้จะมีหนึ่งหน้าเท่ากับหนึ่งหน้าหนังสือ ก่อนหน้านี้แต่ละหน้าหนังสือจะเรนเดอร์เป็นสองหน้า ทำให้ 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. Dependencies

  • แพคเกจ runtime ขึ้นอยู่กับ 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 แบบ fixed‑layout ตอนนี้มีหนึ่งหน้าต่อหนึ่งหน้าหนังสือ, ดังนั้นหน้าที่ N จะเป็นหน้าหนังสือที่ N. เอกสาร EPUB ที่ไฟล์สารบัญมีส่วนขยายอื่นนอกจาก .ncx จะไม่ล้มเหลวด้วย NullReferenceException
  • ผลลัพธ์ PDF ที่ทำ auto‑tagging: เอกสาร PDF ที่บันทึกด้วยการทำ auto‑tagging จะรักษารูปแบบและชื่อเรื่องของแหล่งที่มา อีกต่อไปจะไม่ถูกระบุเป็น PDF/UA-1 เว้นแต่แหล่งที่มาจะเป็นเช่นนั้น, และแหล่งที่ไม่มีชื่อเรื่องจะไม่ได้รับชื่อ “Tagged PDF”
  • โครงการ .NET Framework: การรวมรูปภาพในโครงการ packages.config จะไม่ล้มเหลวในการโหลด System.ValueTuple, และการรวมไฟล์ SVG จะไม่ล้มเหลวในการโหลด netstandard บน .NET Framework 4.6.2 ถึง 4.7.0 runtimes
  • การอัปเดต dependency: แพคเกจพึ่งพา 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

ดาวน์โหลดโดยตรง

ดาวน์โหลดไฟล์ assembly จากหน้า GroupDocs.Merger for .NET 26.10

แหล่งข้อมูล