私たちは、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