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—truesecara default di setiap konstruktor. Selamatrue, tidak ada sumber daya eksternal yang dimuat kecuali yang cocok denganWhitelistedResourcesatau diizinkan oleh handler.WhitelistedResources— awalan URI absolut dari sumber daya yang dimuat saatSkipExternalResourcestrue, misalnyahttps://cdn.example.com/assets/ataufile:///C:/assets/. Kosong secara default.ExternalResourceHandler—nullsecara default.
Perubahan tidak kompatibel mundur:
- Sumber daya eksternal tidak lagi dimuat secara default. Sumber daya remote (
http,https,ftpdan 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 — URIdata:, referensicid:, bagian MHTML, dan media yang dipaketkan — tetap dimuat. Untuk memuat sumber daya eksternal, daftarkan lokasi mereka ke whitelist, atau setSkipExternalResourceskefalseuntuk dokumen yang Anda percayai. LoadOptionskinisealed. Kelas yang diturunkan darinya tidak lagi dapat dikompilasi. GunakanLoadOptionssecara langsung, atau implementasikanILoadOptions; implementasiILoadOptionskhusus yang tidak juga mengimplementasikanIResourceLoadingOptionsakan mendapatkan kebijakan default.- Entri
WhitelistedResourcesyang null, kosong, bukan URI absolut, mengandung query atau fragmen, atau berisi%2F,%5Catau%2Emenyebabkan konstruktorMergermelemparArgumentException(“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 sebagaiInnerException. - 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, danOleWordProcessingOptionsyang menerima jalur file dan nomor halaman merender gambar objek tersemat dengan sumber daya eksternal ditolak, terlepas dari apa yang diizinkanLoadOptionsdokumen target. Untuk menampilkannya, berikan data gambar Anda sendiri ke konstruktor yang menerima data tersebut. - Produk dari paket
GroupDocs.Merger.LowCodeselalu 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,JoinPptxdanRemovePagesPdfmenyelesaikan 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 melemparArgumentNullException.JoinPdf,JoinDocx, danJoinPptxmelemparFileTypeNotSupportedExceptionketika 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)’.”. SebelumnyaJoinPdfdanJoinDocxmenghasilkan output campuran danJoinPptxgagal kemudian dengan pesan lain. Jalur dokumen yang digabungkan null atau kosong melemparArgumentNullException(“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-alihArgumentException.
5. Dependensi
- Paket runtime bergantung pada System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80dan paket.Windowsmereka) atau 9.0.21 (GroupDocs.Merger.Net100danGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.Windows, danGroupDocs.Merger.LowCodejuga bergantung pada System.Formats.Asn1 8.0.2, danGroupDocs.Merger.LowCodepada System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462tidak berubah. - Dalam proyek .NET Framework, paket
GroupDocs.Mergertidak lagi menambahkan binding redirect untuk System.ValueTuple keapp.configatauweb.config(proyek packages.config), dan target build .NET Framework-nya mengaturDependsOnNETStandardketruekecuali 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.
LoadOptionsmemiliki properti baruSkipExternalResources,WhitelistedResources, danExternalResourceHandleruntuk 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
NullReferenceExceptionatauIndexOutOfRangeException, dan dokumen TeX tidak lagi gagal denganArgumentException, 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
.ncxtidak lagi gagal denganNullReferenceException. - 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, sertaJoinPptxmenolak 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 .