GroupDocs.Merger for .NET v26.10 sürümünü duyurmaktan mutluluk duyuyoruz, Ekim 2026 itibarıyla kullanılabilir. Bu sürüm, harici kaynak yüklemesini kontrol etme konusunda büyük iyileştirmeler sunar, EPUB ve TeX işleme sırasında kritik eşzamanlılık sorunlarını çözer, EPUB sayfalama iyileştirmeleri yapar, otomatik etiketli çıktıda PDF formatını ve başlığını korur ve çeşitli .NET Framework ile ilgili hataları düzeltir. Genel olarak, 10 özellik, iyileştirme ve hata düzeltmesi içerir.
Bu sürümde yenilikler
- [Feature] Harici kaynakların varsayılan olarak yüklenmesini atla, güvenilir konumların bir beyaz listesi ve kaynak başına bir işleyici ile
- [Bug] İçindekiler dosyası .ncx uzantısına sahip olmayan EPUB belgelerinde NullReferenceException hatasını düzelt
- [Bug] .NET Framework packages.config projelerinde System.ValueTuple yüklenemeyen görüntü birleştirmelerini düzelt
- [Bug] .NET Framework 4.6.2 - 4.7.0 çalışma zamanlarında SVG belgeleriyle birleştirmelerin başarısız olmasını düzelt
- [Bug] Sabit düzen EPUB sayfalarını her kitap sayfası için bir sayfa olarak render et, ikiye bölmek yerine
- [Bug] System.Security.Cryptography.Pkcs’i 8.0.2 ve 9.0.21 sürümlerine güncelle (CVE-2026-84008, CVE-2026-70162)
- [Bug] Otomatik etiketleme etkinken kaydederken orijinal PDF formatını ve başlığını koru
- [Bug] TeX belgeleri eşzamanlı yüklendiğinde oluşan ArgumentException hatasını düzelt
- [Bug] Düz dosya adı olarak verilen LowCode çıktısını geçerli dizine kaydet ve farklı formatta birleştirilmiş belgeleri reddet
- [Bug] EPUB belgelerinin eşzamanlı işlendiğinde ara sıra NullReferenceException veya IndexOutOfRangeException hatası vermesini düzelt
Genel API değişiklikleri
1. Harici kaynaklar — varsayılan olarak reddedilir (yeni API, geriye uyumsuz)
GroupDocs.Merger.Domain.Options ad alanında yeni genel tipler:
| Type | Description |
|---|---|
| IResourceLoadingOptions | SkipExternalResources, WhitelistedResources ve ExternalResourceHandler tanımlar. LoadOptions bunu uygular. |
| IExternalResourceHandler | OnLoading yöntemi, her harici kaynak yüklenmeden önce çağrılır ve kaynağı izin verebilir, atlayabilir veya değiştirebilir. |
| ExternalResourceLoadingArgs | OnLoading‘e geçirilen kaynak: Uri, Skipped (diğer iki seçeneğin kararına önceden ayarlanmış) ve Data (kaynağı yüklemek yerine kullanılacak içerik). |
LoadOptions yeni özellikleri:
SkipExternalResources— her yapıcıda varsayılan olaraktrue.trueolduğu sürece,WhitelistedResourcesile eşleşen veya işleyici tarafından izin verilenler dışındaki hiçbir harici kaynak yüklenmez.WhitelistedResources—SkipExternalResourcestrueiken yüklenecek kaynakların mutlak URI önekleri, örneğinhttps://cdn.example.com/assets/veyafile:///C:/assets/. Varsayılan olarak boş.ExternalResourceHandler— varsayılan olaraknull.
Geriye uyumsuz değişiklikler:
- Harici kaynaklar artık varsayılan olarak yüklenmez. Uzaktan kaynaklar (
http,https,ftpve diğer şemalar), UNC yolları, yerel dosyalar, belgenin kendi klasöründeki dosyalar ve belge dışına işaret eden göreli referanslar atlanır ve işlem devam eder. Önceki sürümler bunları yüklerdi. HTML, Word ve sunum belgelerinin uzaktan görüntüleri ve stil sayfaları bu nedenle çıktıda eksik olabilir ve HTML ve Word belgelerinin sayfa sayısı değişebilir. Belgenin taşıdığı içerik —data:URI’ları,cid:referansları, MHTML parçaları ve paketlenmiş medya — hâlâ yüklenir. Harici kaynakları yüklemek için konumlarını beyaz listeye ekleyin veya güvendiğiniz belgeler içinSkipExternalResourcesdeğerinifalseyapın. LoadOptionsartıksealed. Ondan türetilen bir sınıf artık derlenemez.LoadOptions‘ı doğrudan kullanın veyaILoadOptions‘ı uygulayın; aynı zamandaIResourceLoadingOptionsuygulamayan özel birILoadOptionsuygulaması varsayılan politikayı alır.- Null, boş, mutlak bir URI olmayan, sorgu veya fragment içeren veya
%2F,%5Cya da%2Eiçeren birWhitelistedResourcesgirdisi,MergeryapıcısınınArgumentExceptionfırlatmasına neden olur (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”). - İşleyici bir istisna fırlatırsa, kaynak atlanır ve işlem
GroupDocsMergerException(“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) fırlatır; işleyicinin istisnasıInnerExceptionolarak eklenir. - EPUB belgeleri ve bazı işlemlerdeki SVG ve SVGZ belgeleri artık dış referanslar için işaretlemeleri kontrol edilir. İşaretlemesi geçerli XML olmayan bir belge
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.”) hatası verir. OleDiagramOptions,OleSpreadsheetOptionsveOleWordProcessingOptionsyapıcıları bir dosya yolu ve sayfa numarası aldığında, gömülü nesnenin görüntüsünü harici kaynaklar reddedilmiş şekilde render eder; hedef belgeninLoadOptionsayarları ne olursa olsun. Görüntülemek için, görüntü verisini alan yapıcıya kendi görüntü verinizi geçirin.GroupDocs.Merger.LowCodepaketinin ürünleri her zaman harici kaynakları reddeder.
Seçenekler Merger oluşturulduğunda okunur ve ona eklenen belgeler bu seçenekleri takip eder.
2. Otomatik etiketli PDF belgeleri kaynağın formatını ve başlığını korur
API değişikliği yok. PdfSaveOptions.AccesibilitySettings.EnableAutoTagging true olarak ayarlanmış bir PDF belgesi kaydedildiğinde PDF formatını ve kaynağın başlığını korur. Önceden her otomatik etiketli belge PDF/UA-1 olarak işaretlenirdi ve başlıksız bir kaynak “Tagged PDF” başlığı alırdı. Otomatik etiketleme mantıksal bir yapı ağacı ekler; bir belgeyi PDF/UA uyumlu yapmaz ve zaten PDF/UA olarak işaretlenmiş bir kaynak işaretini korur.
3. Sabit düzen EPUB belgeleri — her kitap sayfası için bir sayfa
API değişikliği yok. Sabit düzen EPUB belgesi artık her kitap sayfası için bir sayfa içerir. Önceden her kitap sayfası iki sayfa olarak render edilirdi, bu yüzden GetDocumentInfo sayfa sayısını iki katı olarak raporlar ve sayfa N kitap sayfası N ile eşleşmezdi. ExtractPages, RemovePages veya Split gibi sayfa işlemlerine geçirilen sayfa numaraları artık kitap sayfalarına referans verir.
4. GroupDocs.Merger.LowCode — çıktı yolu ve birleştirilen belgeler
JoinPdf,JoinDocx,JoinPptxveRemovePagesPdfgöreli bir çıktı yolunu geçerli çalışma dizinine göre çözer. Düz bir dosya adı olarak verilen çıktı yolu artık geçerli dizine kaydedilir; önceden Merger’ın varsayılan çıktı dizinine kaydedilirdi. Null veya boş bir çıktı yoluArgumentNullExceptionfırlatır.JoinPdf,JoinDocxveJoinPptx, birleştirilen belgenin uzantısı ürünün formatına uymadığında, herhangi bir çıktı yazılmadan önceFileTypeNotSupportedExceptionfırlatır; örneğin “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. ÖncedenJoinPdfveJoinDocxkarışık çıktı üretir veJoinPptxdaha sonra başka bir mesajla başarısız olurdu. Null veya boş bir birleştirilen belge yoluArgumentNullExceptionfırlatır (“The document at index 0 is null or empty.”).- Tüm yedi ürün, uzantısı olmayan bir kaynak yolunda
ArgumentExceptionyerineFileTypeNotSupportedException(“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) fırlatır.
5. Bağımlılıklar
- Çalışma zamanı paketleri System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80ve.Windowspaketleri) veya 9.0.21 (GroupDocs.Merger.Net100veGroupDocs.Merger.Net100.Windows) sürümlerine bağımlıdır.GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsveGroupDocs.Merger.LowCodeayrıca System.Formats.Asn1 8.0.2’ye,GroupDocs.Merger.LowCodeise System.Security.Cryptography.Pkcs 8.0.2’ye bağımlıdır.GroupDocs.Merger.Net462değişmemiştir. - .NET Framework projelerinde,
GroupDocs.Mergerpaketi artıkapp.configveyaweb.config(packages.config projeleri) dosyalarına System.ValueTuple için bir binding redirect eklemez ve .NET Framework derleme hedefleri, proje bunu ayarlamazsaDependsOnNETStandarddeğerinitrueolarak ayarlar.
Yeni özellikler
- Harici kaynakların kontrolü: Bir belgenin referans verdiği uzaktan görüntüler, stil sayfaları, bağlantılı resimler ve diğer dosyalar, siz izin vermezseniz artık yüklenmez.
LoadOptionsyeniSkipExternalResources,WhitelistedResourcesveExternalResourceHandlerözelliklerine sahiptir; güvenilir konumlara izin vermek, güvendiğiniz belgeler için her şeyi izin vermek veya her kaynağı kendi kodunuzda atlamak ya da sağlamak için karar verebilirsiniz. - Eşzamanlılık düzeltmeleri: EPUB belgeleri, birkaç iş parçacığından işlendiğinde artık ara sıra
NullReferenceExceptionveyaIndexOutOfRangeExceptionhatası vermez; TeX belgeleri iseArgumentExceptionhatası vermez. - EPUB belgeleri: Sabit düzen EPUB belgeleri artık her kitap sayfası için bir sayfa içerir, böylece sayfa N kitap sayfası N olur. İçindekiler dosyasının uzantısı
.ncxolmayan EPUB belgeleri artıkNullReferenceExceptionhatası vermez. - Otomatik etiketli PDF çıktısı: Otomatik etiketleme ile kaydedilen bir PDF belgesi, kaynağın formatını ve başlığını korur. Kaynak PDF/UA-1 olarak işaretlenmemişse artık PDF/UA-1 olarak işaretlenmez ve başlıksız bir kaynak artık “Tagged PDF” başlığı almaz.
- .NET Framework projeleri: packages.config projelerinde görüntü birleştirmeleri artık System.ValueTuple yükleyememe hatası vermez ve .NET Framework 4.6.2 - 4.7.0 çalışma zamanlarında SVG belgeleriyle birleştirmeler artık netstandard yükleyememe hatası vermez.
- Düzeltme yapılan bağımlılık: Paketler System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 ve .NET 8.0) veya 9.0.21 (.NET 10.0) sürümlerine bağımlıdır; bu sürümler CVE-2026-84008 ve CVE-2026-70162 hatalarını düzeltir.
- LowCode ürünleri: Düz bir dosya adı olarak verilen çıktı yolu geçerli dizine kaydedilir ve
JoinPdf,JoinDocxveJoinPptxherhangi bir çıktı yazılmadan önce farklı formatta birleştirilmiş belgeyi reddeder.
Kod örneği
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
}
}
}
Güncellemeyi nasıl alabilirsiniz
NuGet
GroupDocs.Merger paketinin en son sürümüne NuGet üzerinden yükseltin: GroupDocs.Merger 26.10.0
dotnet add package GroupDocs.Merger --version 26.10.0
Doğrudan indirme
Derlemeleri GroupDocs.Merger for .NET 26.10 sayfasından indirin.