เรามีความยินดีที่จะประกาศการเปิดตัว 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โดยตรง หรือทำการ implementILoadOptions; การ implementILoadOptionsที่ไม่ได้ implementIResourceLoadingOptionsจะได้รับนโยบายเริ่มต้น- รายการ
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แก้ไขเส้นทางผลลัพธ์แบบสัมพันธ์โดยอิงจากไดเรกทอรีทำงานปัจจุบัน เส้นทางผลลัพธ์ที่ระบุเป็นชื่อไฟล์เปล่าจะบันทึกไปยังไดเรกทอรีปัจจุบัน; ก่อนหน้านี้บันทึกไปยังไดเรกทอรีผลลัพธ์เริ่มต้นของ Mergernullหรือเส้นทางผลลัพธ์ว่างจะโยนArgumentNullExceptionJoinPdf,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