Chúng tôi rất vui thông báo việc phát hành GroupDocs.Merger for .NET v26.10, có sẵn từ tháng 10 năm 2026. Bản phát hành này giới thiệu các cải tiến quan trọng cho việc kiểm soát tải tài nguyên bên ngoài, giải quyết các vấn đề đồng thời nghiêm trọng trong xử lý EPUB và TeX, cải thiện phân trang EPUB, giữ nguyên định dạng PDF và tiêu đề trong đầu ra tự gắn thẻ, và sửa một số lỗi liên quan đến .NET Framework. Tổng cộng, nó bao gồm 10 tính năng, cải tiến và sửa lỗi.

Những gì mới trong bản phát hành này

  • [Feature] Bỏ qua việc tải tài nguyên bên ngoài theo mặc định, với danh sách trắng các vị trí tin cậy và trình xử lý từng tài nguyên
  • [Bug] Sửa NullReferenceException cho tài liệu EPUB mà tệp mục lục không có phần mở rộng .ncx
  • [Bug] Sửa lỗi ghép hình ảnh không tải được System.ValueTuple trong các dự án .NET Framework sử dụng packages.config
  • [Bug] Sửa lỗi ghép tài liệu SVG không thành công trên các runtime .NET Framework 4.6.2 đến 4.7.0
  • [Bug] Kết xuất các trang EPUB bố cục cố định một trang cho mỗi trang sách thay vì chia mỗi trang thành hai
  • [Bug] Cập nhật System.Security.Cryptography.Pkcs lên 8.0.2 và 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] Giữ nguyên định dạng PDF và tiêu đề gốc khi lưu với tính năng tự gắn thẻ được bật
  • [Bug] Sửa ArgumentException khi tài liệu TeX được tải đồng thời
  • [Bug] Lưu đầu ra LowCode được cung cấp dưới dạng tên tệp đơn vào thư mục hiện tại và từ chối các tài liệu đã ghép có định dạng khác
  • [Bug] Sửa lỗi tài liệu EPUB đôi khi thất bại với NullReferenceException hoặc IndexOutOfRangeException khi được xử lý đồng thời

Thay đổi API công cộng

1. Tài nguyên bên ngoài — bị từ chối theo mặc định (API mới, không tương thích ngược)

Các kiểu công cộng mới trong không gian tên GroupDocs.Merger.Domain.Options:

Kiểu Mô tả
IResourceLoadingOptions Định nghĩa SkipExternalResources, WhitelistedResources và ExternalResourceHandler. LoadOptions triển khai nó.
IExternalResourceHandler Phương thức OnLoading của nó được gọi cho mỗi tài nguyên bên ngoài trước khi tải và có thể cho phép, bỏ qua hoặc thay thế nó.
ExternalResourceLoadingArgs Tài nguyên được truyền vào OnLoading: Uri, Skipped (được đặt sẵn theo quyết định của hai tùy chọn khác) và Data (nội dung sẽ dùng thay vì tải tài nguyên).

Các thuộc tính mới của LoadOptions:

  • SkipExternalResources — mặc định là true trong mọi hàm khởi tạo. Khi true, không có tài nguyên bên ngoài nào được tải trừ những tài nguyên khớp với WhitelistedResources hoặc được trình xử lý cho phép.
  • WhitelistedResources — các tiền tố URI tuyệt đối của tài nguyên sẽ được tải khi SkipExternalResources là true, ví dụ https://cdn.example.com/assets/ hoặc file:///C:/assets/. Mặc định là rỗng.
  • ExternalResourceHandler — mặc định là null.

Các thay đổi không tương thích ngược:

  • Tài nguyên bên ngoài không còn được tải theo mặc định. Các tài nguyên từ xa (http, https, ftp và các scheme khác), đường dẫn UNC, tệp cục bộ, bao gồm các tệp trong thư mục của tài liệu, và các tham chiếu tương đối trỏ ra ngoài tài liệu sẽ bị bỏ qua và quá trình sẽ tiếp tục. Các phiên bản trước đây tải chúng. Do đó, hình ảnh và stylesheet từ xa của tài liệu HTML, Word và trình chiếu có thể thiếu trong đầu ra, và số trang của tài liệu HTML và Word có thể thay đổi. Nội dung mà tài liệu mang — URI data:, tham chiếu cid:, các phần MHTML và media được đóng gói — vẫn được tải. Để tải tài nguyên bên ngoài, hãy đưa vị trí của chúng vào danh sách trắng, hoặc đặt SkipExternalResources thành false cho các tài liệu bạn tin cậy.
  • LoadOptions hiện đã được sealed. Một lớp kế thừa từ nó sẽ không còn biên dịch được. Hãy sử dụng LoadOptions trực tiếp, hoặc triển khai ILoadOptions; một triển khai tùy chỉnh ILoadOptions mà không đồng thời triển khai IResourceLoadingOptions sẽ nhận chính sách mặc định.
  • Một mục WhitelistedResources có giá trị null, rỗng, không phải là URI tuyệt đối, chứa truy vấn hoặc fragment, hoặc chứa %2F, %5C hoặc %2E sẽ khiến hàm khởi tạo Merger ném ArgumentException (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).
  • Nếu trình xử lý ném ngoại lệ, tài nguyên sẽ bị bỏ qua và quá trình sẽ ném GroupDocsMergerException (“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) với ngoại lệ của trình xử lý làm InnerException.
  • Các tài liệu EPUB, và các tài liệu SVG và SVGZ trong một số thao tác, hiện sẽ được kiểm tra markup để tìm các tham chiếu bên ngoài. Một tài liệu có markup không phải XML hợp lệ sẽ thất bại với 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.”).
  • Các hàm khởi tạo OleDiagramOptions, OleSpreadsheetOptions và OleWordProcessingOptions nhận đường dẫn tệp và số trang sẽ kết xuất hình ảnh của đối tượng nhúng với tài nguyên bên ngoài bị từ chối, bất kể LoadOptions của tài liệu đích cho phép gì. Để hiển thị chúng, hãy truyền dữ liệu hình ảnh của bạn vào hàm khởi tạo nhận dữ liệu đó.
  • Các sản phẩm của gói GroupDocs.Merger.LowCode luôn từ chối tài nguyên bên ngoài.

Các tùy chọn được đọc khi tạo Merger, và các tài liệu được ghép vào sẽ tuân theo các tùy chọn của nó.

2. Tài liệu PDF tự gắn thẻ giữ định dạng và tiêu đề của nguồn

Không có thay đổi API. Một tài liệu PDF được lưu với PdfSaveOptions.AccesibilitySettings.EnableAutoTagging đặt thành true sẽ giữ định dạng PDF và tiêu đề của nguồn. Trước đây, mọi tài liệu tự gắn thẻ đều được đánh dấu là PDF/UA-1, và một nguồn không có tiêu đề sẽ nhận tiêu đề “Tagged PDF”. Tự gắn thẻ thêm cây cấu trúc logic; nó không làm cho tài liệu tuân thủ PDF/UA, và một nguồn đã được đánh dấu là PDF/UA sẽ giữ dấu đó.

3. Tài liệu EPUB bố cục cố định — một trang cho mỗi trang sách

Không có thay đổi API. Một tài liệu EPUB bố cục cố định hiện có một trang cho mỗi trang sách. Trước đây mỗi trang sách được kết xuất thành hai trang, vì vậy GetDocumentInfo báo cáo số trang gấp đôi và trang N không khớp với trang sách N. Các số trang được truyền vào các thao tác trang như ExtractPages, RemovePages hoặc Split bây giờ tham chiếu tới các trang sách.

4. GroupDocs.Merger.LowCode — đường dẫn đầu ra và tài liệu đã ghép

  • JoinPdf, JoinDocx, JoinPptx và RemovePagesPdf giải quyết đường dẫn đầu ra tương đối dựa trên thư mục làm việc hiện tại. Một đường dẫn đầu ra được cung cấp dưới dạng tên tệp đơn hiện sẽ được lưu vào thư mục hiện tại; trước đây nó được lưu vào thư mục đầu ra mặc định của Merger. Đường dẫn đầu ra null hoặc rỗng sẽ ném ArgumentNullException.
  • JoinPdf, JoinDocx và JoinPptx ném FileTypeNotSupportedException khi phần mở rộng của tài liệu đã ghép không khớp với định dạng của sản phẩm, trước khi bất kỳ đầu ra nào được ghi, ví dụ “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. Trước đây JoinPdf và JoinDocx tạo ra đầu ra hỗn hợp và JoinPptx thất bại sau đó với thông báo khác. Đường dẫn tài liệu đã ghép null hoặc rỗng sẽ ném ArgumentNullException (“The document at index 0 is null or empty.”).
  • Tất cả bảy sản phẩm ném FileTypeNotSupportedException (“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) khi đường dẫn nguồn không có phần mở rộng, thay vì ArgumentException.

5. Phụ thuộc

  • Các gói runtime phụ thuộc vào System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 và các gói .Windows của chúng) hoặc 9.0.21 (GroupDocs.Merger.Net100 và GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows và GroupDocs.Merger.LowCode cũng phụ thuộc vào System.Formats.Asn1 8.0.2, và GroupDocs.Merger.LowCode phụ thuộc vào System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 không thay đổi.
  • Trong các dự án .NET Framework, gói GroupDocs.Merger không còn thêm chuyển hướng ràng buộc cho System.ValueTuple vào app.config hoặc web.config (các dự án packages.config), và các mục tiêu biên dịch .NET Framework của nó đặt DependsOnNETStandard thành true trừ khi dự án tự đặt giá trị này.

Tính năng mới

  • Kiểm soát tài nguyên bên ngoài: Hình ảnh, stylesheet, hình ảnh liên kết và các tệp khác mà tài liệu tham chiếu không còn được tải trừ khi bạn cho phép. LoadOptions có các thuộc tính mới SkipExternalResources, WhitelistedResources và ExternalResourceHandler để cho phép các vị trí tin cậy, cho phép mọi thứ cho các tài liệu bạn tin cậy, hoặc quyết định, bỏ qua hoặc cung cấp mỗi tài nguyên trong mã của bạn.
  • Sửa lỗi đồng thời: Các tài liệu EPUB không còn thất bại ngắt quãng với NullReferenceException hoặc IndexOutOfRangeException, và các tài liệu TeX không còn với ArgumentException, khi chúng được xử lý từ nhiều luồng.
  • Tài liệu EPUB: Các tài liệu EPUB bố cục cố định hiện có một trang cho mỗi trang sách, vì vậy trang N là trang sách N. Các tài liệu EPUB mà tệp mục lục có phần mở rộng khác .ncx không còn thất bại với NullReferenceException.
  • Đầu ra PDF tự gắn thẻ: Một tài liệu PDF được lưu với tự gắn thẻ giữ định dạng và tiêu đề của nguồn. Nó không còn được đánh dấu là PDF/UA-1 trừ khi nguồn đã được, và một nguồn không có tiêu đề không còn nhận tiêu đề “Tagged PDF”.
  • Các dự án .NET Framework: Các ghép hình ảnh trong dự án packages.config không còn thất bại khi tải System.ValueTuple, và các ghép với tài liệu SVG không còn thất bại khi tải netstandard trên các runtime .NET Framework 4.6.2 đến 4.7.0.
  • Phụ thuộc đã được vá: Các gói phụ thuộc vào System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 và .NET 8.0) hoặc 9.0.21 (.NET 10.0), các phiên bản sửa CVE-2026-84008 và CVE-2026-70162.
  • Sản phẩm LowCode: Một đường dẫn đầu ra được cung cấp dưới dạng tên tệp đơn sẽ được lưu vào thư mục hiện tại, và JoinPdf, JoinDocx và JoinPptx từ chối tài liệu đã ghép có định dạng khác trước khi bất kỳ đầu ra nào được ghi.

Ví dụ mã

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
        }
    }
}

Cách nhận cập nhật

NuGet

Nâng cấp lên gói GroupDocs.Merger mới nhất qua NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

Tải trực tiếp

Tải các assembly từ trang GroupDocs.Merger for .NET 26.10 .

Tài nguyên