私たちは、GroupDocs.Merger for .NET v26.10 のリリースを発表できることを嬉しく思います。2026年10月 に利用可能です。このリリースでは、外部リソースの読み込み制御に関する大幅な強化、EPUB および TeX 処理における重要な同時実行問題の解決、EPUB のページ付けの改善、オートタグ付けされた出力における PDF の形式とタイトルの保持、そしていくつかの .NET Framework 関連の失敗の修正が導入されています。全体として、10 件の機能、改善、バグ修正が含まれます。

このリリースの新機能

  • [Feature] デフォルトで外部リソースの読み込みをスキップし、信頼できる場所のホワイトリストとリソースごとのハンドラを使用
  • [Bug] 目次ファイルが .ncx 拡張子を持たない EPUB ドキュメントで発生していた NullReferenceException を修正
  • [Bug] .NET Framework の packages.config プロジェクトで、画像結合時に System.ValueTuple の読み込みに失敗していた問題を修正
  • [Bug] .NET Framework 4.6.2 から 4.7.0 のランタイムで SVG ドキュメントの結合が失敗していた問題を修正
  • [Bug] 固定レイアウト EPUB ページを 1 書籍ページにつき 1 ページとしてレンダリングし、以前のように 2 分割しないように修正
  • [Bug] System.Security.Cryptography.Pkcs を 8.0.2 および 9.0.21 に更新(CVE-2026-84008、CVE-2026-70162)
  • [Bug] オートタグ付けを有効にして保存する際に、元の PDF 形式とタイトルを保持
  • [Bug] TeX ドキュメントを同時に読み込む際に発生していた ArgumentException を修正
  • [Bug] Bare ファイル名で指定された LowCode の出力を現在のディレクトリに保存し、別形式の結合ドキュメントを拒否
  • [Bug] 同時処理時に EPUB ドキュメントが断続的に NullReferenceException または IndexOutOfRangeException をスローしていた問題を修正

パブリック API の変更

1. 外部リソース — デフォルトで拒否(新しい API、下位互換性なし)

GroupDocs.Merger.Domain.Options 名前空間に新しいパブリック型が追加されました:

Type Description
IResourceLoadingOptions SkipExternalResources、WhitelistedResources、ExternalResourceHandler を定義します。LoadOptions が実装しています。
IExternalResourceHandler OnLoading メソッドは外部リソースが読み込まれる前に呼び出され、許可、スキップ、または置換を行うことができます。
ExternalResourceLoadingArgs OnLoading に渡されるリソース:Uri、Skipped(他の2つのオプションの決定に事前設定)、Data(リソースを読み込む代わりに使用するコンテンツ)。

新しい LoadOptions のプロパティ:

  • SkipExternalResources — すべてのコンストラクタでデフォルト true。true の間は、WhitelistedResources に一致するものやハンドラで許可されたものを除き、外部リソースは読み込まれません。
  • WhitelistedResources — SkipExternalResources が true の間に読み込まれるリソースの絶対 URI プレフィックス。例: https://cdn.example.com/assets/ や file:///C:/assets/。デフォルトは空です。
  • ExternalResourceHandler — デフォルトは null。

下位互換性のない変更点:

  • 外部リソースはデフォルトで読み込まれなくなりました。 http、https、ftp などのリモートリソース、UNC パス、ローカルファイル(ドキュメント自身のフォルダー内のファイルを含む)、およびドキュメント外部を指す相対参照はスキップされ、処理は続行されます。以前のバージョンではこれらが読み込まれていました。そのため、HTML、Word、プレゼンテーションドキュメントのリモート画像やスタイルシートが出力に含まれない可能性があり、HTML と Word のページ数が変わることがあります。ドキュメントが保持するコンテンツ(data: URI、cid: 参照、MHTML パーツ、パッケージ化されたメディア)は引き続き読み込まれます。外部リソースを読み込むには、場所をホワイトリストに追加するか、信頼できるドキュメントに対して SkipExternalResources を false に設定してください。
  • LoadOptions が sealed になりました。 それを継承したクラスはコンパイルできなくなります。LoadOptions を直接使用するか、ILoadOptions を実装してください。IResourceLoadingOptions も実装しないカスタム ILoadOptions 実装はデフォルトポリシーを使用します。
  • WhitelistedResources のエントリが null、空、絶対 URI でない、クエリやフラグメントを含む、または %2F、%5C、%2E を含む場合、Merger コンストラクタは ArgumentException(“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”)をスローします。
  • ハンドラが例外をスローした場合、リソースはスキップされ、処理は GroupDocsMergerException(“The external resource handler threw an exception; the resource was skipped. See the inner exception.”)をスローし、ハンドラの例外が InnerException として設定されます。
  • EPUB ドキュメント、および一部の操作での SVG と SVGZ ドキュメントは、外部参照のためにマークアップがチェックされるようになりました。マークアップが正しい XML でないドキュメントは GroupDocsMergerException(“The document’s markup could not be read to check it for external resources, so it was not loaded. Set SkipExternalResources to false without an ExternalResourceHandler to load it without the check.”)で失敗します。
  • OleDiagramOptions、OleSpreadsheetOptions、OleWordProcessingOptions の、ファイルパスとページ番号を受け取るコンストラクタは、対象ドキュメントの LoadOptions が何であれ、外部リソースを拒否した状態で埋め込みオブジェクトの画像をレンダリングします。表示するには、画像データを受け取るコンストラクタに自分の画像データを渡してください。
  • GroupDocs.Merger.LowCode パッケージの製品は常に外部リソースを拒否します。

オプションは Merger が作成される際に読み込まれ、結合されたドキュメントはそのオプションに従います。

2. オートタグ付けされた PDF ドキュメントはソースの形式とタイトルを保持

API の変更はありません。PdfSaveOptions.AccesibilitySettings.EnableAutoTagging を true に設定して保存された PDF ドキュメントは、PDF の形式とソースのタイトルを保持します。以前はすべてのオートタグ付けドキュメントが PDF/UA-1 とマークされ、タイトルのないソースには “Tagged PDF” というタイトルが付与されていました。オートタグ付けは論理構造ツリーを追加しますが、ドキュメントを PDF/UA 準拠にするわけではなく、既に PDF/UA とマークされているソースはそのマークを保持します。

3. 固定レイアウト EPUB ドキュメント — 書籍ページごとに 1 ページ

API の変更はありません。固定レイアウト EPUB ドキュメントは、書籍ページごとに 1 ページになるようになりました。以前は各書籍ページが 2 ページとしてレンダリングされていたため、GetDocumentInfo はページ数を2倍に報告し、ページ N が書籍のページ N と一致しませんでした。ExtractPages、RemovePages、Split などのページ操作に渡すページ番号は、書籍のページを指すようになりました。

4. GroupDocs.Merger.LowCode — 出力パスと結合ドキュメント

  • JoinPdf、JoinDocx、JoinPptx、RemovePagesPdf は相対出力パスを現在の作業ディレクトリに対して解決します。ベアなファイル名で指定された出力パスは現在のディレクトリに保存されるようになり、以前は Merger のデフォルト出力ディレクトリに保存されていました。null または空の出力パスは ArgumentNullException をスローします。
  • JoinPdf、JoinDocx、JoinPptx は、結合するドキュメントの拡張子が製品のフォーマットと一致しない場合、出力が書き込まれる前に FileTypeNotSupportedException をスローします。例: “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”。以前は JoinPdf と JoinDocx が混在した出力を生成し、JoinPptx は後で別のメッセージで失敗していました。null または空の結合ドキュメントパスは ArgumentNullException(“The document at index 0 is null or empty.”)をスローします。
  • 拡張子のないソースパスに対しては、7 つの製品すべてが ArgumentException の代わりに FileTypeNotSupportedException(“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”)をスローします。

5. 依存関係

  • ランタイムパッケージは System.Security.Cryptography.Pkcs 8.0.2(GroupDocs.Merger.Net60、GroupDocs.Merger.Net80 およびそれらの .Windows パッケージ)または 9.0.21(GroupDocs.Merger.Net100 と GroupDocs.Merger.Net100.Windows)に依存しています。GroupDocs.Merger.Net60、GroupDocs.Merger.Net60.Windows、GroupDocs.Merger.LowCode は System.Formats.Asn1 8.0.2 にも依存し、GroupDocs.Merger.LowCode は System.Security.Cryptography.Pkcs 8.0.2 にも依存します。GroupDocs.Merger.Net462 は変更されていません。
  • .NET Framework プロジェクトでは、GroupDocs.Merger パッケージは app.config や web.config(packages.config プロジェクト)に System.ValueTuple のバインディングリダイレクトを追加しなくなり、プロジェクトが設定しない限り .NET Framework ビルドターゲットは DependsOnNETStandard を true に設定します。

新機能

  • 外部リソースの制御: ドキュメントが参照するリモート画像、スタイルシート、リンク画像、その他のファイルは、許可しない限り読み込まれません。LoadOptions には新しい SkipExternalResources、WhitelistedResources、ExternalResourceHandler プロパティが追加され、信頼できる場所を許可したり、信頼できるドキュメントに対してすべてを許可したり、各リソースをスキップまたは独自に提供するかをコードで決定できます。
  • 同時実行の修正: 複数スレッドから処理される際に、EPUB ドキュメントが断続的に NullReferenceException または IndexOutOfRangeException を、TeX ドキュメントが ArgumentException をスローする問題が解消されました。
  • EPUB ドキュメント: 固定レイアウト EPUB ドキュメントは書籍ページごとに 1 ページとなり、ページ N が書籍のページ N になります。目次ファイルが .ncx 以外の拡張子を持つ EPUB ドキュメントは、もはや NullReferenceException で失敗しません。
  • オートタグ付けされた PDF 出力: オートタグ付けで保存された PDF ドキュメントは、形式とソースのタイトルを保持します。ソースが PDF/UA-1 でない限り、PDF/UA-1 とマークされず、タイトルのないソースはもはや “Tagged PDF” というタイトルを取得しません。
  • .NET Framework プロジェクト: packages.config プロジェクトでの画像結合が System.ValueTuple の読み込みに失敗しなくなり、.NET Framework 4.6.2 から 4.7.0 ランタイムで SVG ドキュメントとの結合が netstandard の読み込みに失敗しなくなりました。
  • パッチ適用済み依存関係: パッケージは System.Security.Cryptography.Pkcs 8.0.2(.NET 6.0 と .NET 8.0)または 9.0.21(.NET 10.0)に依存しており、これらのバージョンは CVE-2026-84008 と CVE-2026-70162 を修正します。
  • LowCode 製品: ベアなファイル名で指定された出力パスは現在のディレクトリに保存され、JoinPdf、JoinDocx、JoinPptx は出力が書き込まれる前に別形式の結合ドキュメントを拒否します。

コード例

using System.Collections.Generic;
using GroupDocs.Merger;
using GroupDocs.Merger.Domain;
using GroupDocs.Merger.Domain.Options;

var loadOptions = new LoadOptions(FileType.HTML)
{
    // Load resources from one trusted folder only; everything else stays denied
    WhitelistedResources = new List<string> { "https://cdn.example.com/assets/" }
};

using (var merger = new Merger("page1.html", loadOptions))
{
    merger.Join("page2.html");
    merger.Save("merged.html");
}
using System;
using GroupDocs.Merger.Domain.Options;

public class TrustedPngHandler : IExternalResourceHandler
{
    public void OnLoading(ExternalResourceLoadingArgs args)
    {
        Uri uri;
        if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
            && uri.Scheme == Uri.UriSchemeHttps
            && uri.Host == "cdn.example.com"
            && uri.AbsolutePath.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
        {
            args.Skipped = false;   // allow; any other resource keeps the default decision
        }
    }
}

アップデートの取得方法

NuGet

NuGet を通じて最新の GroupDocs.Merger パッケージにアップグレードしてください: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

直接ダウンロード

以下のページからアセンブリをダウンロードしてください: GroupDocs.Merger for .NET 26.10

リソース