We’re happy to announce GroupDocs.Conversion for .NET 25.10, available as of October 2025.
This minor release brings a set of page‑layout enhancements, new load‑option capabilities, and a handful of critical bug fixes. The most visible change is a public API refactor that groups margin and size settings into dedicated objects, improving consistency across all conversion options.

Bu sürümde yenilikler

ID Özellik
CONVERSIONNET‑8032 page size, margins and orientation ayarlarını EmailLoadOptions içinde dönüşümden önce ayarlama desteği ekleyin.
CONVERSIONNET‑8013 SpreadsheetOptions içinde page margins ayarlarını dönüşümden önce ayarlama desteği ekleyin.
CONVERSIONNET‑8012 SpreadsheetOptions içinde page size ayarlarını dönüşümden önce ayarlama desteği ekleyin.
CONVERSIONNET‑8009 TxtLoadOptions ve WordProcessingLoadOptions içinde page size ayarlarını dönüşümden önce ayarlama desteği ekleyin.
CONVERSIONNET‑8008 TxtLoadOptions ve WordProcessingLoadOptions içinde page margins ayarlarını dönüşümden önce ayarlama desteği ekleyin.

These additions let you fine‑tune the layout of the source document before the conversion step, giving you tighter control over the appearance of the resulting files.

API Yeniden Düzenleme – Sayfa Düzeni Ayarları (Kırıcı Değişiklikler)

⚠️ BREAKING CHANGE (effective v26.1) – Yirmi ayrı margin/size özelliği kullanımdan kaldırıldı ve bir sonraki büyük sürümde kaldırılacak.
Yeni model, eski skaler özelliklerin yerini alacak iki yardımcı nesne tanıtır:

Etkilenen sınıf Kullanımdan Kaldırılan özellikler Değiştirme
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) PDF ile aynı PDF ile aynı
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

Yeni yardımcı sınıflar

public class PageMarginOptions
{
    public float? Top { get; set; }
    public float? Bottom { get; set; }
    public float? Left { get; set; }
    public float? Right { get; set; }
}

public sealed class PageSizeOptions
{
    public PageSize PageSize { get; set; }
    public float PageWidth { get; set; }   // Setting this forces PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // Setting this forces PageSize = PageSize.Custom
}

Geçiş kılavuzu

Sayfa kenar boşluklarını taşıma

Eski yaklaşım (kullanımdan kaldırıldı)

var options = new PdfConvertOptions
{
    MarginTop    = 10,
    MarginBottom = 10,
    MarginLeft   = 20,
    MarginRight  = 20
};

Yeni yaklaşım (önerilen)

var options = new PdfConvertOptions
{
    MarginSettings = new PageMarginOptions
    {
        Top    = 10,
        Bottom = 10,
        Left   = 20,
        Right  = 20
    }
};

Sayfa boyutu ayarlarının taşınması

Eski yaklaşım (kullanımdan kaldırıldı)

// Predefined size
var pdfOptions = new PdfConvertOptions
{
    PageSize = PageSize.A4
};

// Custom dimensions
var wpOptions = new WordProcessingConvertOptions
{
    PageWidth  = 612, // points (Letter width)
    PageHeight = 792  // points (Letter height)
};

Yeni yaklaşım (önerilen)

// Predefined size
var pdfOptions = new PdfConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageSize = PageSize.A4
    }
};

// Custom dimensions
var wpOptions = new WordProcessingConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageWidth  = 612,   // points
        PageHeight = 792    // points
        // PageSize automatically becomes PageSize.Custom
    }
};

Adopting the new objects eliminates ambiguity (the previous API mixed points and pixels) and aligns all conversion options under a common, discoverable model.

Düzeltmeler ve geliştirmeler

ID Sorun tipi Açıklama
CONVERSIONNET‑8031 Hata PreserveOriginalDate değeri false olarak ayarlandığında .NET üzerinde önceki sürümlerde göz ardı ediliyordu.
CONVERSIONNET‑8023 Hata Fluent‑syntax dönüşümleri, açık bir convert option sağlanmadığında başarısız oluyordu.
CONVERSIONNET‑8020 Hata WordProcessing dönüşümü, eksik Microsoft.Extensions.DependencyInjection (v8.0.0.0) nedeniyle yakalanmamış bir istisna fırlattı.
CONVERSIONNET‑8006 Hata WordProcessingConvertOptions içindeki PageWidth/PageHeight değerleri nokta yerine piksel olarak ele alınıyordu.
CONVERSIONNET‑8005 Hata PdfConvertOptions.Margin* özellikleri PDF dönüşümü sırasında dikkate alınmıyordu.

These fixes tighten reliability across the most common conversion scenarios and bring the library in line with expected .NET behavior.

Güncellemeyi nasıl alabilirsiniz

  • NuGet – En son GroupDocs.Conversion paketine yükseltin:

    dotnet add package GroupDocs.Conversion --version 25.10

    (Aynı paket .NET 6+, .NET Framework 4.6.2 ve .NET Core için çalışır.)

  • Doğrudan indirme – .NET ve .NET Framework için derlemeler sürüm sayfasında mevcuttur:
    https://releases.groupdocs.com/conversion/net/25-10/

Kaynaklar