We zijn blij aan te kondigen GroupDocs.Conversion voor .NET 25.10, beschikbaar vanaf oktober 2025.
Deze kleine release brengt een reeks pagina‑lay-outverbeteringen, nieuwe laad‑optie mogelijkheden en een aantal kritieke bugfixes. De meest zichtbare wijziging is een publieke API‑refactor die marge‑ en formaatinstellingen groepeert in toegewijde objecten, waardoor de consistentie over alle conversie‑opties wordt verbeterd.

Wat is er nieuw in deze release

ID Functie
CONVERSIONNET‑8032 Voeg ondersteuning toe voor het instellen van paginagrootte, marges en oriëntatie in EmailLoadOptions vóór de conversie.
CONVERSIONNET‑8013 Voeg ondersteuning toe voor het instellen van paginamarges in SpreadsheetOptions vóór de conversie.
CONVERSIONNET‑8012 Voeg ondersteuning toe voor het instellen van paginagrootte in SpreadsheetOptions vóór de conversie.
CONVERSIONNET‑8009 Voeg ondersteuning toe voor het instellen van paginagrootte in TxtLoadOptions en WordProcessingLoadOptions vóór de conversie.
CONVERSIONNET‑8008 Voeg ondersteuning toe voor het instellen van paginamarges in TxtLoadOptions en WordProcessingLoadOptions vóór de conversie.

Deze toevoegingen stellen je in staat de lay-out van het brondocument voor de conversiestap fijn af te stemmen, waardoor je meer controle krijgt over het uiterlijk van de resulterende bestanden.

API‑refactoring – Paginalay-outinstellingen (Doorbrekende wijzigingen)

⚠️ BREAKING CHANGE (effectief v26.1) – Twintig afzonderlijke marge-/grootte‑eigenschappen zijn verouderd en worden verwijderd in de volgende major‑versie.
Het nieuwe model introduceert twee helper‑objecten die de oude scalaire eigenschappen vervangen:

Betrokken klasse Verouderde eigenschappen Vervanging
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) Hetzelfde als PDF Hetzelfde als PDF
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

Nieuwe helper‑klassen

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
}

Migratie‑gids

Migreren van paginamarges

Oude aanpak (verouderd)

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

Nieuwe aanpak (aanbevolen)

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

Migreren van paginagrootte‑instellingen

Oude aanpak (verouderd)

// 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)
};

Nieuwe aanpak (aanbevolen)

// 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
    }
};

Het adopteren van de nieuwe objecten elimineert ambiguïteit (de vorige API mengde points en pixels) en brengt alle conversie‑opties onder een gemeenschappelijk, gemakkelijk te ontdekken model.

Oplossingen en verbeteringen

ID Soort probleem Beschrijving
CONVERSIONNET‑8031 Bug PreserveOriginalDate ingesteld op false werd eerder genegeerd op .NET.
CONVERSIONNET‑8023 Bug Fluent‑syntax‑conversies mislukt wanneer geen expliciete conversie‑opties werden opgegeven.
CONVERSIONNET‑8020 Bug WordProcessing-conversie gooide een ongehandelde uitzondering vanwege ontbrekende Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 Bug WordProcessingConvertOptions beschouwde PageWidth/PageHeight als pixels in plaats van points.
CONVERSIONNET‑8005 Bug PdfConvertOptions.Margin*-eigenschappen werden niet gerespecteerd tijdens PDF-conversie.

Deze fixes verhogen de betrouwbaarheid in de meest voorkomende conversiescenario’s en brengen de bibliotheek in lijn met verwacht .NET‑gedrag.

Hoe de update te verkrijgen

  • NuGet – Upgrade naar het nieuwste GroupDocs.Conversion‑pakket:

    dotnet add package GroupDocs.Conversion --version 25.10

    (Hetzelfde pakket werkt voor .NET 6+, .NET Framework 4.6.2, en .NET Core.)

  • Direct downloaden – Assemblies voor zowel .NET als .NET Framework zijn beschikbaar op de release‑pagina:
    https://releases.groupdocs.com/conversion/net/25-10/

Bronnen