Wir freuen uns, GroupDocs.Conversion für .NET 25.10 anzukündigen, verfügbar ab Oktober 2025.
Dieses kleinere Release bringt eine Reihe von Seitenlayout‑Verbesserungen, neue Lade‑Option‑Funktionen und eine Handvoll kritischer Fehlerbehebungen mit. Die sichtbarste Änderung ist ein öffentlicher API‑Refactor, der Rand‑ und Größen‑Einstellungen in dedizierte Objekte gruppiert und die Konsistenz über alle Konvertierungsoptionen hinweg verbessert.

Was ist neu in diesem Release

ID Funktion
CONVERSIONNET‑8032 Unterstützung zum Festlegen von Seitengröße, Rändern und Orientierung in EmailLoadOptions vor der Konvertierung hinzufügen.
CONVERSIONNET‑8013 Unterstützung zum Festlegen von Seitenrändern in SpreadsheetOptions vor der Konvertierung hinzufügen.
CONVERSIONNET‑8012 Unterstützung zum Festlegen von Seitengröße in SpreadsheetOptions vor der Konvertierung hinzufügen.
CONVERSIONNET‑8009 Unterstützung zum Festlegen von Seitengröße in TxtLoadOptions und WordProcessingLoadOptions vor der Konvertierung hinzufügen.
CONVERSIONNET‑8008 Unterstützung zum Festlegen von Seitenrändern in TxtLoadOptions und WordProcessingLoadOptions vor der Konvertierung hinzufügen.

Diese Ergänzungen ermöglichen es Ihnen, das Layout des Quelldokuments vor dem Konvertierungsschritt fein abzustimmen und geben Ihnen mehr Kontrolle über das Aussehen der resultierenden Dateien.

API-Refactoring – Seiteneinstellungs‑Parameter (Breaking Changes)

⚠️ BREAKING CHANGE (effective v26.1) – Zwanzig Einzel‑Rand‑/Größen‑Eigenschaften sind veraltet und werden in der nächsten Hauptversion entfernt.
Das neue Modell führt zwei Hilfsobjekte ein, die die alten Skalar‑Eigenschaften ersetzen:

Betroffene Klasse Veraltete Eigenschaften Ersatz
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) Same as PDF Same as PDF
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

Neue Hilfsklassen

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
}

Migrationsleitfaden

Migration von Seitenrändern

Alter Ansatz (veraltet)

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

Neuer Ansatz (empfohlen)

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

Migration von Seitengrößeneinstellungen

Alter Ansatz (veraltet)

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

Neuer Ansatz (empfohlen)

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

Die Verwendung der neuen Objekte beseitigt Mehrdeutigkeiten (die vorherige API vermischte Punkte und Pixel) und richtet alle Konvertierungsoptionen an einem gemeinsamen, leicht auffindbaren Modell aus.

Fehlerbehebungen und Erweiterungen

ID Fehlertyp Beschreibung
CONVERSIONNET‑8031 Fehler PreserveOriginalDate auf false wurde zuvor in .NET ignoriert.
CONVERSIONNET‑8023 Fehler Fluent‑Syntax‑Konvertierungen schlugen fehl, wenn keine expliziten Konvertierungsoptionen angegeben wurden.
CONVERSIONNET‑8020 Fehler WordProcessing-Konvertierung löste eine nicht abgefangene Ausnahme aus wegen fehlender Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 Fehler WordProcessingConvertOptions behandelten PageWidth/PageHeight als Pixel anstelle von Punkten.
CONVERSIONNET‑8005 Fehler PdfConvertOptions.Margin*‑Eigenschaften wurden bei der PDF-Konvertierung nicht berücksichtigt.

Diese Korrekturen erhöhen die Zuverlässigkeit in den gängigsten Konvertierungsszenarien und bringen die Bibliothek in Einklang mit dem erwarteten .NET‑Verhalten.

So erhalten Sie das Update

  • NuGet – Aktualisieren Sie auf das neueste GroupDocs.Conversion‑Paket:

    dotnet add package GroupDocs.Conversion --version 25.10

    (Das gleiche Paket funktioniert für .NET 6+, .NET Framework 4.6.2 und .NET Core.)

  • Direkter Download – Assemblies für sowohl .NET als auch .NET Framework stehen auf der Release‑Seite zur Verfügung:
    https://releases.groupdocs.com/conversion/net/25-10/

Ressourcen