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 olarak true. true olduğu sürece, WhitelistedResources ile eşleşen veya işleyici tarafından izin verilenler dışındaki hiçbir harici kaynak yüklenmez.
  • WhitelistedResources — SkipExternalResources true iken yüklenecek kaynakların mutlak URI önekleri, örneğin https://cdn.example.com/assets/ veya file:///C:/assets/. Varsayılan olarak boş.
  • ExternalResourceHandler — varsayılan olarak null.

Geriye uyumsuz değişiklikler:

  • Harici kaynaklar artık varsayılan olarak yüklenmez. Uzaktan kaynaklar (http, https, ftp ve 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çin SkipExternalResources değerini false yapın.
  • LoadOptions artık sealed. Ondan türetilen bir sınıf artık derlenemez. LoadOptions‘ı doğrudan kullanın veya ILoadOptions‘ı uygulayın; aynı zamanda IResourceLoadingOptions uygulamayan özel bir ILoadOptions uygulaması varsayılan politikayı alır.
  • Null, boş, mutlak bir URI olmayan, sorgu veya fragment içeren veya %2F, %5C ya da %2E içeren bir WhitelistedResources girdisi, Merger yapıcısının ArgumentException fı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ı InnerException olarak 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, OleSpreadsheetOptions ve OleWordProcessingOptions yapı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 belgenin LoadOptions ayarları 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.LowCode paketinin ü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, JoinPptx ve RemovePagesPdf gö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ı yolu ArgumentNullException fırlatır.
  • JoinPdf, JoinDocx ve JoinPptx, birleştirilen belgenin uzantısı ürünün formatına uymadığında, herhangi bir çıktı yazılmadan önce FileTypeNotSupportedException fı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)’.”. Önceden JoinPdf ve JoinDocx karışık çıktı üretir ve JoinPptx daha sonra başka bir mesajla başarısız olurdu. Null veya boş bir birleştirilen belge yolu ArgumentNullException fırlatır (“The document at index 0 is null or empty.”).
  • Tüm yedi ürün, uzantısı olmayan bir kaynak yolunda ArgumentException yerine FileTypeNotSupportedException (“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.Net80 ve .Windows paketleri) veya 9.0.21 (GroupDocs.Merger.Net100 ve GroupDocs.Merger.Net100.Windows) sürümlerine bağımlıdır. GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows ve GroupDocs.Merger.LowCode ayrıca System.Formats.Asn1 8.0.2’ye, GroupDocs.Merger.LowCode ise System.Security.Cryptography.Pkcs 8.0.2’ye bağımlıdır. GroupDocs.Merger.Net462 değişmemiştir.
  • .NET Framework projelerinde, GroupDocs.Merger paketi artık app.config veya web.config (packages.config projeleri) dosyalarına System.ValueTuple için bir binding redirect eklemez ve .NET Framework derleme hedefleri, proje bunu ayarlamazsa DependsOnNETStandard değerini true olarak 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. LoadOptions yeni SkipExternalResources, WhitelistedResources ve ExternalResourceHandler ö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 NullReferenceException veya IndexOutOfRangeException hatası vermez; TeX belgeleri ise ArgumentException hatası 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ı .ncx olmayan EPUB belgeleri artık NullReferenceException hatası 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, JoinDocx ve JoinPptx herhangi 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.

Kaynaklar