S potěšením oznamujeme GroupDocs.Conversion pro .NET 25.10, dostupné od října 2025.
Tato menší verze přináší řadu vylepšení rozvržení stránky, nové možnosti načítacích parametrů a několik kritických oprav chyb. Neviditelnější změnou je refaktor veřejného API, který seskupuje nastavení okrajů a velikosti do samostatných objektů a zlepšuje konzistenci napříč všemi možnostmi konverze.

Co je nového v této verzi

ID Funkce
CONVERSIONNET‑8032 Přidána podpora pro nastavení velikosti stránky, okrajů a orientace v EmailLoadOptions před konverzí.
CONVERSIONNET‑8013 Přidána podpora pro nastavení okrajů stránky v SpreadsheetOptions před konverzí.
CONVERSIONNET‑8012 Přidána podpora pro nastavení velikosti stránky v SpreadsheetOptions před konverzí.
CONVERSIONNET‑8009 Přidána podpora pro nastavení velikosti stránky v TxtLoadOptions a WordProcessingLoadOptions před konverzí.
CONVERSIONNET‑8008 Přidána podpora pro nastavení okrajů stránky v TxtLoadOptions a WordProcessingLoadOptions před konverzí.

Tyto doplňky vám umožní jemně doladit rozvržení zdrojového dokumentu před krokem konverze, což vám poskytne přesnější kontrolu nad vzhledem výsledných souborů.

Refaktoring API – Nastavení rozvržení stránky (Rozbíjející změny)

⚠️ BREAKING CHANGE (effective v26.1) – Dvacet samostatných vlastností okrajů/velikostí je zastaralých a bude v další hlavní verzi odstraněno.
Nový model zavádí dva pomocné objekty, které nahrazují staré skalární vlastnosti:

Postižená třída Zastaralé vlastnosti Náhrada
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

Nové pomocné třídy

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
}

Průvodce migrací

Migrace okrajů stránky

Starý přístup (zastaralý)

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

Nový přístup (doporučený)

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

Migrace nastavení velikosti stránky

Starý přístup (zastaralý)

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

Nový přístup (doporučený)

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

Přijetím nových objektů se eliminuje nejasnost (předchozí API míchat body a pixely) a všechny možnosti konverze jsou sjednoceny pod společným, snadno objevitelným modelem.

Opravy a vylepšení

ID Typ problému Popis
CONVERSIONNET‑8031 Chyba PreserveOriginalDate nastavený na false byl dříve ignorován v .NET.
CONVERSIONNET‑8023 Chyba Konverze pomocí fluent syntaxe selhaly, pokud nebyly předány explicitní možnosti konverze.
CONVERSIONNET‑8020 Chyba Konverze WordProcessing vyvolala neošetřenou výjimku kvůli chybějícímu Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 Chyba WordProcessingConvertOptions interpretoval PageWidth/PageHeight jako pixely místo bodů.
CONVERSIONNET‑8005 Chyba Vlastnosti PdfConvertOptions.Margin* nebyly během PDF konverze respektovány.

Tyto opravy zvyšují spolehlivost v nejčastějších scénářích konverze a přibližují knihovnu očekávanému chování .NET.

Jak získat aktualizaci

  • NuGet – Aktualizujte na nejnovější balíček GroupDocs.Conversion:

    dotnet add package GroupDocs.Conversion --version 25.10

    (Stejný balíček funguje pro .NET 6+, .NET Framework 4.6.2 a .NET Core.)

  • Direct download – Assemblies pro .NET i .NET Framework jsou k dispozici na stránce vydání:
    https://releases.groupdocs.com/conversion/net/25-10/

Zdroje