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.

Apa yang baru di rilis ini

ID Fitur
CONVERSIONNET‑8032 Tambahkan dukungan untuk mengatur ukuran halaman, margin, dan orientasi di EmailLoadOptions sebelum konversi.
CONVERSIONNET‑8013 Tambahkan dukungan untuk mengatur margin halaman di SpreadsheetOptions sebelum konversi.
CONVERSIONNET‑8012 Tambahkan dukungan untuk mengatur ukuran halaman di SpreadsheetOptions sebelum konversi.
CONVERSIONNET‑8009 Tambahkan dukungan untuk mengatur ukuran halaman di TxtLoadOptions dan WordProcessingLoadOptions sebelum konversi.
CONVERSIONNET‑8008 Tambahkan dukungan untuk mengatur margin halaman di TxtLoadOptions dan WordProcessingLoadOptions sebelum konversi.

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.

Refactoring API – Pengaturan Tata Letak Halaman (Perubahan Breaking)

⚠️ PERUBAHAN BREAKING (efektif v26.1) – Twenty individual margin/size properties are deprecated and will be removed in the next major version.
The new model introduces two helper objects that replace the old scalar properties:

Kelas yang Terpengaruh Properti yang Tidak Digunakan Pengganti
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

Kelas pembantu baru

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
}

Panduan Migrasi

Memigrasi margin halaman

Pendekatan lama (tidak lagi digunakan)

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

Pendekatan baru (disarankan)

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

Memigrasi pengaturan ukuran halaman

Pendekatan lama (tidak lagi digunakan)

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

Pendekatan baru (disarankan)

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

Mengadopsi objek baru menghilangkan ambiguitas (API sebelumnya mencampur poin dan piksel) dan menyelaraskan semua opsi konversi di bawah model yang umum dan mudah ditemukan.

Perbaikan dan peningkatan

ID Jenis Masalah Deskripsi
CONVERSIONNET‑8031 Bug PreserveOriginalDate yang disetel ke false sebelumnya diabaikan pada .NET.
CONVERSIONNET‑8023 Bug Konversi sintaks Fluent gagal ketika tidak ada opsi konversi eksplisit yang diberikan.
CONVERSIONNET‑8020 Bug Konversi WordProcessing melemparkan pengecualian tak tertangani karena Microsoft.Extensions.DependencyInjection yang hilang (v8.0.0.0).
CONVERSIONNET‑8006 Bug WordProcessingConvertOptions memperlakukan PageWidth/PageHeight sebagai piksel alih-alih poin.
CONVERSIONNET‑8005 Bug Properti PdfConvertOptions.Margin* tidak dihormati selama konversi PDF.

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

Cara mendapatkan pembaruan

  • NuGet – Tingkatkan ke paket GroupDocs.Conversion terbaru:

    dotnet add package GroupDocs.Conversion --version 25.10

    (Paket yang sama berfungsi untuk .NET 6+, .NET Framework 4.6.2, dan .NET Core.)

  • Unduhan langsung – Assemblies untuk .NET dan .NET Framework tersedia di halaman rilis:
    https://releases.groupdocs.com/conversion/net/25-10/

Sumber Daya