Kami senang mengumumkan rilis GroupDocs.Merger for .NET v26.10, tersedia sejak Oktober 2026. Rilis ini memperkenalkan peningkatan utama untuk mengontrol pemuatan sumber daya eksternal, menyelesaikan masalah konkruensi kritis dalam pemrosesan EPUB dan TeX, meningkatkan paginasi EPUB, mempertahankan format PDF dan judul dalam output yang ditandai otomatis, serta memperbaiki beberapa kegagalan terkait .NET Framework. Secara keseluruhan, mencakup 10 fitur, perbaikan, dan perbaikan bug.

Apa yang baru di rilis ini

  • [Feature] Lewati pemuatan sumber daya eksternal secara default, dengan daftar putih lokasi tepercaya dan penangan per-sumber daya
  • [Bug] Memperbaiki NullReferenceException untuk dokumen EPUB yang file daftar isi-nya tidak memiliki ekstensi .ncx
  • [Bug] Memperbaiki penggabungan gambar yang gagal memuat System.ValueTuple dalam proyek .NET Framework packages.config
  • [Bug] Memperbaiki penggabungan dengan dokumen SVG yang gagal pada runtime .NET Framework 4.6.2 hingga 4.7.0
  • [Bug] Merender halaman EPUB tata letak tetap satu per halaman buku alih-alih membagi setiap halaman menjadi dua
  • [Bug] Memperbarui System.Security.Cryptography.Pkcs ke 8.0.2 dan 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] Menjaga format PDF asli dan judul saat menyimpan dengan auto-tagging diaktifkan
  • [Bug] Memperbaiki ArgumentException ketika dokumen TeX dimuat secara bersamaan
  • [Bug] Menyimpan output LowCode yang diberikan sebagai nama file saja ke direktori saat ini dan menolak dokumen yang digabungkan dengan format lain
  • [Bug] Memperbaiki dokumen EPUB yang kadang-kadang gagal dengan NullReferenceException atau IndexOutOfRangeException saat diproses secara bersamaan

Perubahan API Publik

1. Sumber daya eksternal — ditolak secara default (API baru, tidak kompatibel mundur)

Tipe publik baru di namespace GroupDocs.Merger.Domain.Options:

Tipe Deskripsi
IResourceLoadingOptions Mendefinisikan SkipExternalResources, WhitelistedResources, dan ExternalResourceHandler. LoadOptions mengimplementasikannya.
IExternalResourceHandler Metode OnLoading-nya dipanggil untuk setiap sumber daya eksternal sebelum dimuat dan dapat mengizinkan, melewatkan, atau menggantinya.
ExternalResourceLoadingArgs Sumber daya yang diteruskan ke OnLoading: Uri, Skipped (telah diatur sebelumnya berdasarkan keputusan dua opsi lainnya) dan Data (konten yang digunakan alih-alih memuat sumber daya).

Properti baru dari LoadOptions:

  • SkipExternalResources — true secara default di setiap konstruktor. Selama true, tidak ada sumber daya eksternal yang dimuat kecuali yang cocok dengan WhitelistedResources atau diizinkan oleh handler.
  • WhitelistedResources — awalan URI absolut dari sumber daya yang dimuat saat SkipExternalResources true, misalnya https://cdn.example.com/assets/ atau file:///C:/assets/. Kosong secara default.
  • ExternalResourceHandler — null secara default.

Perubahan tidak kompatibel mundur:

  • Sumber daya eksternal tidak lagi dimuat secara default. Sumber daya remote (http, https, ftp dan skema lain), jalur UNC, file lokal, termasuk file di folder dokumen itu sendiri, dan referensi relatif yang mengarah ke luar dokumen dilewati, dan operasi berlanjut. Versi sebelumnya memuatnya. Gambar dan stylesheet remote dari dokumen HTML, Word, dan presentasi dapat hilang dari output, dan jumlah halaman dokumen HTML dan Word dapat berubah. Konten yang dibawa dokumen — URI data:, referensi cid:, bagian MHTML, dan media yang dipaketkan — tetap dimuat. Untuk memuat sumber daya eksternal, daftarkan lokasi mereka ke whitelist, atau set SkipExternalResources ke false untuk dokumen yang Anda percayai.
  • LoadOptions kini sealed. Kelas yang diturunkan darinya tidak lagi dapat dikompilasi. Gunakan LoadOptions secara langsung, atau implementasikan ILoadOptions; implementasi ILoadOptions khusus yang tidak juga mengimplementasikan IResourceLoadingOptions akan mendapatkan kebijakan default.
  • Entri WhitelistedResources yang null, kosong, bukan URI absolut, mengandung query atau fragmen, atau berisi %2F, %5C atau %2E menyebabkan konstruktor Merger melempar ArgumentException (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).
  • Jika handler melempar, sumber daya dilewati dan operasi melempar GroupDocsMergerException (“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) dengan pengecualian handler sebagai InnerException.
  • Dokumen EPUB, serta dokumen SVG dan SVGZ dalam beberapa operasi, kini memeriksa markup mereka untuk referensi eksternal. Dokumen yang markup-nya bukan XML yang terbentuk dengan baik gagal dengan 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.”).
  • Konstruktor OleDiagramOptions, OleSpreadsheetOptions, dan OleWordProcessingOptions yang menerima jalur file dan nomor halaman merender gambar objek tersemat dengan sumber daya eksternal ditolak, terlepas dari apa yang diizinkan LoadOptions dokumen target. Untuk menampilkannya, berikan data gambar Anda sendiri ke konstruktor yang menerima data tersebut.
  • Produk dari paket GroupDocs.Merger.LowCode selalu menolak sumber daya eksternal.

Opsi dibaca saat Merger dibuat, dan dokumen yang digabungkan kepadanya mengikuti opsi tersebut.

2. Dokumen PDF yang ditandai otomatis mempertahankan format dan judul sumber

Tidak ada perubahan API. Dokumen PDF yang disimpan dengan PdfSaveOptions.AccesibilitySettings.EnableAutoTagging diatur ke true mempertahankan format PDF dan judul sumber. Sebelumnya setiap dokumen yang ditandai otomatis ditandai sebagai PDF/UA-1, dan sumber tanpa judul mendapatkan judul “Tagged PDF”. Auto-tagging menambahkan pohon struktur logis; itu tidak membuat dokumen menjadi patuh PDF/UA, dan sumber yang sudah ditandai sebagai PDF/UA mempertahankan tandanya.

3. Dokumen EPUB tata letak tetap — satu halaman per halaman buku

Tidak ada perubahan API. Dokumen EPUB tata letak tetap kini memiliki satu halaman per halaman buku. Sebelumnya setiap halaman buku dirender menjadi dua halaman, sehingga GetDocumentInfo melaporkan dua kali jumlah halaman dan halaman N tidak cocok dengan halaman buku N. Nomor halaman yang diberikan ke operasi halaman seperti ExtractPages, RemovePages, atau Split kini mengacu pada halaman buku.

4. GroupDocs.Merger.LowCode — jalur output dan dokumen yang digabungkan

  • JoinPdf, JoinDocx, JoinPptx dan RemovePagesPdf menyelesaikan jalur output relatif terhadap direktori kerja saat ini. Jalur output yang diberikan sebagai nama file saja kini disimpan ke direktori saat ini; sebelumnya disimpan ke direktori output default Merger. Jalur output yang null atau kosong melempar ArgumentNullException.
  • JoinPdf, JoinDocx, dan JoinPptx melempar FileTypeNotSupportedException ketika ekstensi dokumen yang digabungkan tidak sesuai dengan format produk, sebelum ada output yang ditulis, misalnya “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. Sebelumnya JoinPdf dan JoinDocx menghasilkan output campuran dan JoinPptx gagal kemudian dengan pesan lain. Jalur dokumen yang digabungkan null atau kosong melempar ArgumentNullException (“The document at index 0 is null or empty.”).
  • Semua tujuh produk melempar FileTypeNotSupportedException (“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) untuk jalur sumber tanpa ekstensi, alih-alih ArgumentException.

5. Dependensi

  • Paket runtime bergantung pada System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 dan paket .Windows mereka) atau 9.0.21 (GroupDocs.Merger.Net100 dan GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows, dan GroupDocs.Merger.LowCode juga bergantung pada System.Formats.Asn1 8.0.2, dan GroupDocs.Merger.LowCode pada System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 tidak berubah.
  • Dalam proyek .NET Framework, paket GroupDocs.Merger tidak lagi menambahkan binding redirect untuk System.ValueTuple ke app.config atau web.config (proyek packages.config), dan target build .NET Framework-nya mengatur DependsOnNETStandard ke true kecuali proyek mengaturnya.

Fitur Baru

  • Kontrol sumber daya eksternal: Gambar remote, stylesheet, gambar terhubung, dan file lain yang direferensikan dokumen tidak lagi dimuat kecuali Anda mengizinkannya. LoadOptions memiliki properti baru SkipExternalResources, WhitelistedResources, dan ExternalResourceHandler untuk mengizinkan lokasi tepercaya, mengizinkan semua untuk dokumen yang Anda percayai, atau memutuskan, melewatkan, atau menyediakan setiap sumber daya dalam kode Anda sendiri.
  • Perbaikan konkruensi: Dokumen EPUB tidak lagi gagal secara intermiten dengan NullReferenceException atau IndexOutOfRangeException, dan dokumen TeX tidak lagi gagal dengan ArgumentException, ketika diproses dari beberapa thread.
  • Dokumen EPUB: Dokumen EPUB tata letak tetap kini memiliki satu halaman per halaman buku, sehingga halaman N adalah halaman buku N. Dokumen EPUB yang file daftar isinya memiliki ekstensi selain .ncx tidak lagi gagal dengan NullReferenceException.
  • Output PDF yang ditandai otomatis: Dokumen PDF yang disimpan dengan auto-tagging mempertahankan format dan judul sumber. Itu tidak lagi ditandai sebagai PDF/UA-1 kecuali sumbernya memang, dan sumber tanpa judul tidak lagi mendapatkan judul “Tagged PDF”.
  • Proyek .NET Framework: Penggabungan gambar dalam proyek packages.config tidak lagi gagal memuat System.ValueTuple, dan penggabungan dengan dokumen SVG tidak lagi gagal memuat netstandard pada runtime .NET Framework 4.6.2 hingga 4.7.0.
  • Dependensi yang dipatch: Paket-paket bergantung pada System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 dan .NET 8.0) atau 9.0.21 (.NET 10.0), versi yang memperbaiki CVE-2026-84008 dan CVE-2026-70162.
  • Produk LowCode: Jalur output yang diberikan sebagai nama file saja disimpan ke direktori saat ini, dan JoinPdf, JoinDocx, serta JoinPptx menolak dokumen yang digabungkan dengan format lain sebelum ada output yang ditulis.

Contoh Kode

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

Cara mendapatkan pembaruan

NuGet

Tingkatkan ke paket GroupDocs.Merger terbaru melalui NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

Unduhan Langsung

Unduh assembly dari halaman GroupDocs.Merger for .NET 26.10 .

Sumber Daya