GroupDocs.Merger for .NET 26.9 – Eylül 2026 Sürüm Öne Çıkanları

Biz, GroupDocs.Merger for .NET v26.9 sürümünün Eylül 2026 itibarıyla yayınlandığını duyurmaktan mutluluk duyuyoruz. Bu sürüm, elektronik tabloların satır‑satır birleştirilmesini, PageBuilder aracılığıyla TIFF sayfa seçimini iyileştirmeyi, önizleme boyut işleme geliştirmelerini, Visio ve DOC çıktısı ile ilgili eşzamanlılık sorunlarını çözmeyi ve birkaç sessiz hata durumunu net istisnalarla değiştirerek API’yı daha sağlam ve öngörülebilir hâle getiriyor.

What’s new in this release

• [Feature] Birden fazla dosyadan Excel satırlarını tek bir sayfada birleştir (MERGERNET-2198)
• [Feature] PageBuilder sayfa seçimini ilk TIFF belgesine uygula (MERGERNET-1372)
• [Improvement] SetLicense lisans dosyasını bulamadığında bir istisna fırlat (MERGERNET-2183)
• [Improvement] SetLicense içinde boş bir lisans akışı reddedilir (MERGERNET-2184)
• [Improvement] Desteklenmeyen bir formata görüntü veya ses dosyası eklenmeye çalışıldığında net bir istisna fırlat (MERGERNET-2190)
• [Improvement] Çapraz‑platform paketlerinden System.Drawing.Common kaldırıldı ve eksik bağımlılıklar net bir şekilde raporlanıyor (MERGERNET-2202)
• [Bug] Merger, bir belgeyi yol ile açtığında veya birleştirdiğinde kaynak dosyayı kapat (MERGERNET-2187)
• [Bug] Merger oluşturulurken akış fabrikası yalnızca bir kez çağrılır (MERGERNET-2189)
• [Bug] Çoklu iş parçacığında PDF veya XPS belgeleri DOC’a birleştirildiğinde bozuk DOC çıktısı düzeltilir (MERGERNET-2192)
• [Bug] Sayfa numarası belirtilmediğinde her sayfaya sayfa yönlendirme değişikliği uygulanır (MERGERNET-2194)
• [Bug] İstenen önizleme Genişliği ve Yüksekliği her belge formatı ailesinde dikkate alınır (MERGERNET-2196)
• [Bug] Sayfa numarası olmadan çağrılan ExtractPages ve RemovePages artık sessizce boş veya değişmemiş bir belge üretmek yerine reddedilir (MERGERNET-2197)
• [Bug] Visio belgeleri, eşzamanlı işlendiğinde ArgumentNullException trueTypeFont hatasıyla ara sıra başarısız olma sorunu giderildi (MERGERNET-2199)
• [Bug] Gömülü bir dosyanın değiştirilme tarihi olmadığında PDF portföyleri NullReferenceException hatasıyla başarısız olma sorunu giderildi (MERGERNET-2200)

Genel API değişiklikleri

1. Elektronik tablo birleştirme — satır‑satır mod (yeni API)

GroupDocs.Merger.Domain.Options ad alanında yeni genel tipler:

• SkipRows, her birleştirilen dosyanın ilk N satırını (ör. başlık satırı) atlar. İlk belge her zaman tamamen alınır. SkipRows ve SheetMatching özellikleri Worksheets modunda etkisizdir.
• Desteklenen formatlar: XLSX, XLS, XLSM, XLSB, XLTX, XLTM, XLT, XLAM ve ODS.
• Taşınanlar: hücre değerleri, formüller (göreceli referanslar ayarlanır), stiller, birleştirilmiş hücreler ve satır yükseklikleri. Taşınmayanlar: grafikler, resimler, pivot tablolar, tablolar, koşullu biçimlendirme ve veri doğrulama.
• Negatif SkipRows değeri GroupDocsMergerException (“The count of rows to skip can not be negative.”) hatası üretir.
• Satır sınırlarını aşmak (XLS/XLT için 65 536, diğerleri için 1 048 576) GroupDocsMergerException fırlatır.
• ApplyPageBuilder, Rows modunda bir elektronik tablo beklemede iken GroupDocsMergerException fırlatır.

2. TIFF — PageBuilder ilk belgenin sayfa seçimini uygular

API değişikliği yoktur. CreatePageBuilder ve ApplyPageBuilder artık ilk TIFF belgesinden seçilen sayfaları uygular; daha önce ilk belgenin tüm sayfaları her zaman dahil edilirdi. PageBuilder kullanılmayan birleştirmeler önceki gibi davranır.

ImageJoinOptions ile birleştirme yapıldıktan sonra CreatePageBuilder ve ApplyPageBuilder artık GroupDocsMergerException fırlatır, çünkü birleştirilen görüntüler bir sayfa dizisi yerine tek bir yerleşim içinde birleştirilir.

3. Lisanslama — SetLicense artık sessizce başarısız olmaz

• License.SetLicense(string licensePath) lisans dosyası bulunamadığında InvalidOperationException (“License not found: …”) fırlatır.
• License.SetLicense(Stream licenseStream) boş bir akış için ArgumentNullException fırlatır.

4. Boş sayfa listesiyle sayfa işlemleri

• Sayfa numarası olmadan çağrılan ExtractPages ve RemovePages artık GroupDocsMergerException (“There are no page numbers to extract.” / “There are no page numbers to remove.”) fırlatır.
• Sayfa numarası olmadan çağrılan ChangeOrientation, PDF, XPS, Word işleme, elektronik tablo ve Visio belgelerinde her sayfanın yönünü değiştirir.

5. Önizleme boyutu

GeneratePreview artık her sayfa görüntüsünü istenen Width ve Height değerlerine yeniden boyutlandırır — ikisi de verildiğinde tam olarak o boyuta uzatılır. Negatif Width veya Height değeri GroupDocsMergerException fırlatır.

6. System.Drawing.Common ve eksik bağımlılıklar

• Çapraz‑platform paketleri (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80, GroupDocs.Merger.Net100) artık System.Drawing.Common bağımlılığı içermez.
• Eksik çalışma zamanı bağımlılıkları MissingDependencyException fırlatır; eksik bileşen ve kurulum talimatları mesaj içinde belirtilir.

7. Desteklenmeyen formatlara görüntü ve ses birleştirme

Bir görüntü veya ses dosyasını desteklenmeyen bir belge formatına birleştirmeye çalışmak FileTypeNotSupportedException (“Joining ‘…’ into ‘…’ is not supported”) fırlatır.

Yeni özellikler

• Satır‑satır elektronik tablo birleştirme: Birden fazla elektronik tablonun satırları tek bir sayfada birleştirilebilir; başlık satırlarını atlama ve sayfaları konuma göre eşleştirme seçenekleri mevcuttur.
• TIFF belgeleri için PageBuilder: PageBuilder ile yapılan sayfa seçimi artık ilk TIFF belgesine de uygulanır — daha önce tüm sayfalar her zaman dahil edilirdi.
• Doğru önizleme boyutları: GeneratePreview artık her belge formatı ailesi için istenen Width ve Height değerlerinde görüntüler döndürür.
• Eşzamanlılık düzeltmeleri: Visio ve DOC çıktısı artık çoklu iş parçacığında işlenirken ara sıra başarısız olmaz.
• Kaynak yönetimi: Dosya yolu ile açılan veya birleştirilen belgeler artık kaynak dosyayı açık tutmaz; akış fabrikaları tam olarak bir kez çağrılır.
• Daha net hatalar: Önceden sessizce başarısız olan çeşitli işlemler artık açıklayıcı istisnalar fırlatır.

Kod örneği

using GroupDocs.Merger;
using GroupDocs.Merger.Domain.Options;

using (var merger = new Merger("january.xlsx"))
{
    var options = new SpreadsheetJoinOptions
    {
        Mode = SpreadsheetJoinMode.Rows,   // mevcut sayfalara satır ekle
        SkipRows = 1                        // her birleştirilen dosyanın başlık satırını atla
    };

    merger.Join("february.xlsx", options);
    merger.Join("march.xlsx", options);
    merger.Save("q1.xlsx");
}

Güncellemeyi nasıl alabilirsiniz

NuGet

• Paket: GroupDocs.Merger 26.9.0
• Kurulum komutu:

  dotnet add package GroupDocs.Merger --version 26.9.0
  

Doğrudan indirme

• GroupDocs.Merger for .NET 26.9

Kaynaklar

• Tam Sürüm Notları
• Dokümantasyon
• Free Support Forum