GroupDocs.Conversion for .NET 26.8 – Ağustos 2026 Sürüm Öne Çıkanları

Bu Sürümde Yenilikler

Genel API değişiklikleri

⚠️ Geriye Uyumsuz Değişiklikler – Aşağıdaki güncellemeler mevcut genel davranışı değiştirir. Çalışma zamanı hatalarını önlemek için kodunuzu buna göre ayarlayın.

1. LoadOptions.Format artık format ayarlanmamışsa hata fırlatmak yerine null döndürür

Etkilenen sınıflar: tüm 28 tipli load‑options (ör. SpreadsheetLoadOptions, PdfLoadOptions, CadLoadOptions, …)

Ne değişti
Format özelliği bir format atanmadığında okunmaya çalışıldığında istisna fırlatılırdı. Şimdi null döndürür, bu da basit bir null‑kontrolüne izin verir.

Geçiş örneği

var loadOptions = new SpreadsheetLoadOptions();

if (loadOptions.Format == null)
{
    // Yeni kod yolu – daha önce getter hata fırlattığı için ulaşılamazdı.
}

Kılavuz
loadOptions.Format etrafındaki herhangi bir try/catch bloğunu null‑kontrolü ile değiştirin. FileType.Unknown ile karşılaştırma yapmayın; doğru test == null‘dır.

2. CadLoadOptions.LayoutNames için tam eşleşme doğrulaması ve ayrıntılı hata raporlaması

Etkilenen sınıf: CadLoadOptions

Ne değişti
LayoutNames artık çizimin düzen adlarıyla tam olarak (büyük/küçük harfe duyarlı) eşleşir. Hiçbiri eşleşmezse, dönüşüm mevcut düzenleri ve eşleşmeyen isteği listeleyen bir InvalidLoadOptionsException ile başarısız olur.

Geçiş örneği

using GroupDocs.Conversion.Exceptions;

try
{
    using var converter = new Converter("drawing.dwg",
        ctx => new CadLoadOptions { LayoutNames = new[] { "layout1" } });
    converter.Convert("out.pdf", new PdfConvertOptions());
}
catch (InvalidLoadOptionsException ex)
{
    // Örnek mesaj:
    // "No layout name in CadLoadOptions.LayoutNames matches this drawing, which carries
    //  Model, Layout1, Layout2. Requested: layout1. Names are matched exactly, so a name
    //  that differs only in case is a different name."
    Console.WriteLine(ex.Message);
}

Kılavuz

• Düzen adlarının doğru yazıldığından ve kaynak çizimde kullanılan büyük/küçük harfe uygun olduğundan emin olun.
• Yalnızca bir alt küme düzen gerekiyorsa, tam adları sağlayın; eşleşmeyen girdiler yok sayılır ve eşleşen düzenler hâlâ işlenir.

3. Çok‑sayfalı CAD çizimleri artık her sayfa için bir çıktı birimi üretir

Etkilenen sınıflar: Converter, PresentationConvertOptions, PdfConvertOptions

Ne değişti
Daha önce, birden fazla kağıt‑alanı düzenine sahip bir çizimi dönüştürmek tek bir düzleştirilmiş görüntü/slayt üretirdi. Şimdi dönüşüm, her düzen için ayrı çıktı birimleri (slaytlar, sayfalar vb.) oluşturur ve bu birimler düzenin sayfa ayarına göre boyutlandırılır. Converter.GetDocumentInfo().PagesCount oluşturulan birim sayısını gösterir.

Geçiş örneği – dönüşüm

using var converter = new Converter("multi-layout.dwg");

// Üç sayfa girdi, üç slayt çıktı – daha önce tek bir düzleştirilmiş slayt.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Geçiş örneği – sayfa sayısını sorgulama

using var converter = new Converter("multi-layout.dwg");
int sheets = converter.GetDocumentInfo().PagesCount; // Üç düzen için 3 döndürür

Kılavuz

• Sonraki işleme (ör. UI sayfalama, dosya adlandırma) çoklu çıktı dosyaları/sayfaları ele alacak şekilde ayarlayın.
• Tek‑sayfalı çizimler için davranış değişmez.
• Tek istisna CAD → PDF/UA‑1’dir; bu hâlâ tek etiketli sayfa render eder.

4. Hangi alanların dönüştürüleceğini açıkça kontrol eden yeni CadLoadOptions.LayoutScope özelliği

Etkilenen sınıf: CadLoadOptions

Ne değişti
LayoutScope size Model, Layouts veya Both (varsayılan) yüklenip yüklenmeyeceğini belirtme imkanı verir.

• LayoutNames ayarlandığında, LayoutScope göz ardı edilir çünkü açık adlar önceliklidir.
• En az bir sayfa içeren bir çizim için hiçbir sayfa üretmeyen bir kapsam seçildiğinde, artık sessizce varsayılan alanları render etmek yerine bir InvalidLoadOptionsException fırlatılır.

Geçiş örneği – yalnızca kağıt‑alanı düzenlerini dönüştür

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

using var converter = new Converter("drawing.dwg",
    ctx => new CadLoadOptions { LayoutScope = CadLayoutScope.Layouts });
converter.Convert("layouts.pdf", new PdfConvertOptions());

Kılavuz

• Varsayılan arka uç seçimine güvenen mevcut kod, Both varsayılan olduğu için çalışmaya devam eder.
• Model alanını dışlamak veya yalnızca onu dahil etmek için LayoutScope‘u sırasıyla CadLayoutScope.Model veya CadLayoutScope.Layouts olarak ayarlayın.
• Daha önce boş bir LayoutNames dizisi vererek düzenleri filtrelemeye çalıştıysanız, bu deseni uygun bir LayoutScope değeriyle değiştirin; böylece hiçbir sayfa seçilmediğinde net bir hata alırsınız.

Yeni özellikler

Gelişmiş CAD Düzen Kontrolü: Belirli CAD düzenlerini seçin, her düzeni kendi slaytı, çalışma sayfası, sayfası, görüntüsü veya SVG bölgesi olarak dönüştürün ve CadLayoutScope ile model alanı, kağıt düzenleri veya her ikisini seçin. Bu, düzen‑başına hassas çıktı sağlar ve yönlendirme ve sayfa‑boyutu gibi sayfa‑özel ayarları dikkate alır.

Genişletilmiş Arşiv Desteği: XAR ve CAB formatları artık sıkıştırma belgeleri için hem kaynak hem hedef olarak kullanılabilir, bu da bu arşiv türlerine sorunsuz dönüşüm sağlar.

Modern Diyagram Uyumluluğu: Mermaid MMD dosyaları diyagram kaynakları olarak kullanılabilir ve Drawio dosyaları dönüşüm hedefi olarak desteklenir, böylece güncel diyagram araçlarını dönüşüm hatlarınıza kolayca entegre edebilirsiniz.

Kritik Stabilite İyileştirmeleri: EML → PDF, DOCX şekil dış hatları, sunum üstbilgi/altbilgi ve bozuk özet bağlantıları, Linux küçük resim oluşturma ve DWG sayfa‑yönlendirme işleme hataları düzeltildi. Bu düzeltmeler e‑posta, ofis, sunum ve CAD iş akışlarında güvenilirliği artırır.

Kod örneği

using var converter = new Converter("multi-layout.dwg");

// Üç sayfa girdi, üç slayt çıktı – daha önce tek bir düzleştirilmiş slayt.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Güncellemeyi nasıl alabilirsiniz

NuGet

Install-Package GroupDocs.Conversion -Version 26.8

GroupDocs.Conversion 26.8 on NuGet

Doğrudan indirme

Sürüm notlarında doğrudan indirme bağlantısı sağlanmamaktadır.

Kaynaklar

• SpreadsheetLoadOptions reference
• PdfLoadOptions reference
• CadLoadOptions reference
• Converter class reference
• PresentationConvertOptions reference
• PdfConvertOptions reference