Z przyjemnością ogłaszamy GroupDocs.Conversion for .NET 25.10, dostępny od października 2025.
Ta drobna aktualizacja wprowadza zestaw ulepszeń układu stron, nowe możliwości opcji ładowania oraz kilka krytycznych poprawek błędów. Najbardziej widoczną zmianą jest publiczny refaktoring API, który grupuje ustawienia marginesów i rozmiarów w dedykowane obiekty, poprawiając spójność we wszystkich opcjach konwersji.

Co nowego w tej wersji

ID Funkcja
CONVERSIONNET‑8032 Dodano obsługę ustawiania rozmiaru strony, marginesów i orientacji w EmailLoadOptions przed konwersją.
CONVERSIONNET‑8013 Dodano obsługę ustawiania marginesów strony w SpreadsheetOptions przed konwersją.
CONVERSIONNET‑8012 Dodano obsługę ustawiania rozmiaru strony w SpreadsheetOptions przed konwersją.
CONVERSIONNET‑8009 Dodano obsługę ustawiania rozmiaru strony w TxtLoadOptions i WordProcessingLoadOptions przed konwersją.
CONVERSIONNET‑8008 Dodano obsługę ustawiania marginesów strony w TxtLoadOptions i WordProcessingLoadOptions przed konwersją.

Te dodatki pozwalają precyzyjnie dostosować układ dokumentu źródłowego przed etapem konwersji, dając większą kontrolę nad wyglądem powstałych plików.

Refaktoryzacja API – Ustawienia układu stron (Zmiany niekompatybilne)

⚠️ ZMIANA NIEKOMPATYBILNA (obowiązuje od v26.1) – Dwadzieścia poszczególnych właściwości marginesów/rozmiaru jest przestarzałych i zostanie usuniętych w następnej wersji głównej.
Nowy model wprowadza dwa obiekty pomocnicze, które zastępują stare właściwości skalarne:

Klasa objęta zmianą Przestarzałe właściwości Zastąpienie
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

Nowe klasy pomocnicze

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; }   // Ustawienie tego wymusza PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // Ustawienie tego wymusza PageSize = PageSize.Custom
}

Przewodnik migracji

Migracja marginesów stron

Stare podejście (przestarzałe)

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

Nowe podejście (rekomendowane)

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

Migracja ustawień rozmiaru stron

Stare podejście (przestarzałe)

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

Nowe podejście (rekomendowane)

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

Przyjęcie nowych obiektów eliminuje niejasności (poprzednie API mieszało punkty i piksele) i ujednolica wszystkie opcje konwersji w ramach wspólnego, łatwo wykrywalnego modelu.

Poprawki i ulepszenia

ID Typ problemu Opis
CONVERSIONNET‑8031 Błąd PreserveOriginalDate ustawione na false było wcześniej ignorowane w .NET.
CONVERSIONNET‑8023 Błąd Konwersje w stylu Fluent nie powiodły się, gdy nie podano explicite opcji konwersji.
CONVERSIONNET‑8020 Błąd Konwersja WordProcessing zgłosiła nieobsługiwany wyjątek z powodu brakującego Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 Błąd WordProcessingConvertOptions traktowało PageWidth/PageHeight jako piksele zamiast punktów.
CONVERSIONNET‑8005 Błąd Właściwości PdfConvertOptions.Margin* nie były respektowane podczas konwersji PDF.

Te poprawki zwiększają niezawodność w najczęstszych scenariuszach konwersji i dopasowują bibliotekę do oczekiwanego zachowania .NET.

Jak uzyskać aktualizację

  • NuGet – Uaktualnij do najnowszego GroupDocs.Conversion pakietu:

    dotnet add package GroupDocs.Conversion --version 25.10

    (Ten sam pakiet działa na .NET 6+, .NET Framework 4.6.2 oraz .NET Core.)

  • Bezpośrednie pobranie – Zestawy (assemblies) dla .NET i .NET Framework są dostępne na stronie wydania:
    https://releases.groupdocs.com/conversion/net/25-10/

Zasoby