We’re happy to announce GroupDocs.Conversion for .NET 25.10, available as of October 2025.
このマイナーバージョンはページレイアウトの強化、新しいロードオプション機能、そしていくつかの重要なバグ修正をもたらします。最も目立つ変更は、マージンとサイズ設定を専用オブジェクトにまとめた public API refactor で、すべての変換オプションの一貫性が向上します。

このリリースの新機能

ID 機能
CONVERSIONNET‑8032 変換前に EmailLoadOptions で ページサイズ、余白、向き を設定できるようにサポートを追加しました。
CONVERSIONNET‑8013 変換前に SpreadsheetOptions で ページ余白 を設定できるようにサポートを追加しました。
CONVERSIONNET‑8012 変換前に SpreadsheetOptions で ページサイズ を設定できるようにサポートを追加しました。
CONVERSIONNET‑8009 変換前に TxtLoadOptions と WordProcessingLoadOptions で ページサイズ を設定できるようにサポートを追加しました。
CONVERSIONNET‑8008 変換前に TxtLoadOptions と WordProcessingLoadOptions で ページ余白 を設定できるようにサポートを追加しました。

これらの追加により、変換ステップの 前 にソースドキュメントのレイアウトを細かく調整でき、生成ファイルの外観をより厳密にコントロールできるようになります。

APIリファクタリング – ページレイアウト設定 (破壊的変更)

⚠️ BREAKING CHANGE (effective v26.1) – 20 個の個別マージン/サイズプロパティが deprecated とされ、次のメジャーリリースで削除されます。
新しいモデルは、古いスカラー プロパティに代わる 2 つのヘルパーオブジェクトを導入します。

対象クラス 非推奨プロパティ 置換
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

新しいヘルパークラス

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
}

移行ガイド

ページ余白の移行

旧アプローチ（非推奨）

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

新アプローチ（推奨）

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

ページサイズ設定の移行

旧アプローチ（非推奨）

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

新アプローチ（推奨）

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

新しいオブジェクトを採用することで、曖昧さ（従来の API がポイントとピクセルを混在させていた）を排除し、すべての変換オプションを共通で見つけやすいモデルに統一できます。

修正と機能強化

ID 問題タイプ 説明
CONVERSIONNET‑8031 バグ .NET 上で PreserveOriginalDate を false に設定しても無視されていた問題を修正しました。
CONVERSIONNET‑8023 バグ 明示的な変換オプションが指定されていない場合に Fluent‑syntax 変換が失敗していた問題を修正しました。
CONVERSIONNET‑8020 バグ Microsoft.Extensions.DependencyInjection (v8.0.0.0) が欠如していたために WordProcessing 変換が例外をスローしていた問題を修正しました。
CONVERSIONNET‑8006 バグ WordProcessingConvertOptions が PageWidth/PageHeight をピクセルとして扱っていた問題を修正しました。
CONVERSIONNET‑8005 バグ PDF 変換時に PdfConvertOptions.Margin* プロパティが無視されていた問題を修正しました。

これらの修正により、最も一般的な変換シナリオでの信頼性が向上し、期待される .NET の動作に合わせられました。

アップデートの取得方法

  • NuGet – 最新の GroupDocs.Conversion パッケージにアップグレードします:

    dotnet add package GroupDocs.Conversion --version 25.10

    （同じパッケージは .NET 6+、.NET Framework 4.6.2、.NET Core でも動作します。）

  • Direct download – .NET と .NET Framework の両方用アセンブリがリリースページで入手可能です:
    https://releases.groupdocs.com/conversion/net/25-10/

リソース