GroupDocs.Conversion for .NET 26.8 – 2026年8月 リリースハイライト

このリリースの新機能

パブリック API の変更

⚠️ 後方互換性のない変更 – 以下の更新は既存の公開動作を変更します。実行時エラーを防ぐためにコードを調整してください。

1. LoadOptions.Format が未設定の場合に例外を投げる代わりに null を返すようになりました

影響を受けるクラス: すべての 28 種類の型付き LoadOptions（例: SpreadsheetLoadOptions、PdfLoadOptions、CadLoadOptions など）

変更点
フォーマットが割り当てられる前に Format プロパティを取得すると例外が発生していましたが、現在は null を返すようになり、単純な null チェックで対応可能です。

移行例

var loadOptions = new SpreadsheetLoadOptions();

if (loadOptions.Format == null)
{
    // 新しいコードパス – 以前は getter が例外を投げて到達できませんでした。
}

ガイダンス
loadOptions.Format 周りの try/catch を null チェックに置き換えてください。FileType.Unknown との比較は行わず、== null で判定してください。

2. CadLoadOptions.LayoutNames の完全一致検証と詳細エラーレポート

影響を受けるクラス: CadLoadOptions

変更点
LayoutNames は現在、図面のレイアウト名と 完全一致（大文字小文字を区別） で比較されます。いずれも一致しない場合、利用可能なレイアウトと不一致の要求を列挙した InvalidLoadOptionsException がスローされます。

移行例

using GroupDocs.Conversion.Exceptions;

try
{
    using var converter = new Converter("drawing.dwg",
        ctx => new CadLoadOptions { LayoutNames = new[] { "layout1" } });
    converter.Convert("out.pdf", new PdfConvertOptions());
}
catch (InvalidLoadOptionsException ex)
{
    // 例示メッセージ:
    // "CadLoadOptions.LayoutNames に一致するレイアウト名がこの図面にありません。利用可能レイアウトは
    //  Model, Layout1, Layout2 です。要求された名前: layout1。名前は完全一致で比較されるため、
    //  大文字小文字が異なるだけでも別名とみなされます。"
    Console.WriteLine(ex.Message);
}

ガイダンス

• レイアウト名は正確に、かつソース図面で使用されているケースと同じように記述してください。
• 必要なレイアウトだけを指定する場合は、正確な名前を提供してください。不一致のエントリは無視され、マッチしたレイアウトは引き続き変換されます。

3. 複数シートの CAD 図面がシートごとに個別の出力単位を生成するようになりました

影響を受けるクラス: Converter、PresentationConvertOptions、PdfConvertOptions

変更点
従来は、複数の紙空間レイアウトを持つ図面を変換すると 単一の平坦化画像/スライド が生成されていました。現在は各レイアウトごとに 個別の出力単位（スライド、ページ等）が作成され、レイアウトのページ設定に合わせたサイズになります。Converter.GetDocumentInfo().PagesCount は生成された単位数を返します。

移行例 – 変換

using var converter = new Converter("multi-layout.dwg");

// 3 シート → 3 スライド 出力（以前は 1 スライド）.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

移行例 – ページ数取得

using var converter = new Converter("multi-layout.dwg");
int sheets = converter.GetDocumentInfo().PagesCount; // レイアウトが 3 つなら 3 を返す

ガイダンス

• UI のページングやファイル命名など、下流処理が複数出力に対応できるよう調整してください。
• 単一シートの図面では挙動は変わりません。
• 例外は CAD → PDF/UA‑1 で、依然として単一のタグ付ページが生成されます。

4. 新しい CadLoadOptions.LayoutScope プロパティで変換対象空間を明示的に制御

影響を受けるクラス: CadLoadOptions

変更点
LayoutScope により Model、Layouts、または Both（既定） のいずれかを指定してロード対象を選択できます。

• LayoutNames が設定されている場合、LayoutScope は無視され、明示的な名前が優先されます。
• 少なくとも 1 シートが存在する図面で、選択したスコープがシートを生成しない場合は、サイレントにデフォルト空間が使用される代わりに InvalidLoadOptionsException がスローされます。

移行例 – 紙レイアウトのみ変換

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

using var converter = new Converter("drawing.dwg",
    ctx => new CadLoadOptions { LayoutScope = CadLayoutScope.Layouts });
converter.Convert("layouts.pdf", new PdfConvertOptions());

ガイダンス

• 既存コードはデフォルトで Both が使用されるため、従来通り動作します。
• モデル空間だけ、または紙レイアウトだけを対象にしたい場合はそれぞれ CadLayoutScope.Model または CadLayoutScope.Layouts を設定してください。
• 以前に空の LayoutNames 配列でフィルタリングしようとしていた場合は、適切な LayoutScope に置き換えて、シートが選択されなかったときに明確なエラーが得られるようにしてください。

新機能

高度な CAD レイアウト制御: 特定の CAD レイアウトを選択し、各レイアウトを個別のスライド、ワークシート、ページ、画像、または SVG 領域に変換できます。CadLayoutScope によりモデル空間、紙レイアウト、またはその両方を選択でき、シート固有の向きやページサイズ設定も尊重されます。

拡張されたアーカイブサポート: XAR と CAB 形式が圧縮ドキュメントの変換元・変換先として利用可能になり、これらのアーカイブタイプ間のシームレスな変換が実現します。

最新ダイアグラム相互運用性: Mermaid MMD ファイルをダイアグラムの変換元として、Drawio ファイルを変換先としてサポートし、モダンな図表作成ツールとの統合が容易になります。

重要な安定性向上: EML → PDF、DOCX シェイプのアウトライン、プレゼンテーションのヘッダー/フッター、壊れたサマリーリンク、Linux 環境でのサムネイル生成、DWG シート向き設定に関する変換失敗を修正しました。これにより、メール、オフィス、プレゼンテーション、CAD ワークフロー全体の信頼性が向上します。

コード例

using var converter = new Converter("multi-layout.dwg");

// 3 シート → 3 スライド 出力（以前は 1 スライド）.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

アップデートの取得方法

NuGet

Install-Package GroupDocs.Conversion -Version 26.8

GroupDocs.Conversion 26.8 on NuGet

直接ダウンロード

リリースノートに直接ダウンロードリンクは提供されていません。

リソース

• SpreadsheetLoadOptions reference
• PdfLoadOptions reference
• CadLoadOptions reference
• Converter class reference
• PresentationConvertOptions reference
• PdfConvertOptions reference