We’re happy to announce the release of GroupDocs.Conversion for .NET v26.10, available as of October 2026. This release is about control over what a document is allowed to load: your code can now decide about every external resource a document asks for, and the defaults are safe for documents from unknown sources. It also makes conversions honour the requested output format and page selection, fixes a range of conversion failures and .NET Framework loading problems, and updates a security‑sensitive dependency — 60 features, improvements, and bug fixes in total.
ハイライト
各ドキュメントが読み込むことができるものを決定する
ドキュメントはしばしば外部リソースを参照します:CDN 上の画像、スタイルシート、スクリプト、3D テクスチャ、XBRL タクソノミーなど。26.10 では、これらのリクエストをすべて確認し、コードで判断できるようになりました。IExternalResourceHandler を実装し、ロードオプションの ExternalResourceHandler プロパティに設定します。ハンドラはデフォルトの判定が既に設定された状態で各リソースを受け取り、許可、スキップ、または(ほとんどの形式で)コンテンツ自体を供給できます。たとえば独自のキャッシュから取得すれば、外部へのリクエストは一切行われません。
このハンドラは、デフォルトが許可するものに加えて、信頼できるホストから JPEG 画像をロードします:
public class TrustedJpegHandler : IExternalResourceHandler
{
public void OnLoading(ExternalResourceLoadingArgs args)
{
Uri uri;
if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
&& uri.Scheme == Uri.UriSchemeHttps
&& string.Equals(uri.Host, "cdn.example.com", StringComparison.OrdinalIgnoreCase)
&& (uri.AbsolutePath.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
|| uri.AbsolutePath.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase)))
{
args.Skipped = false;
}
}
}
WebLoadOptions loadOptions = new WebLoadOptions
{
ExternalResourceHandler = new TrustedJpegHandler()
};
using (Converter converter = new Converter("sample.html", (LoadContext loadContext) => loadOptions))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
ハンドラは Web、XML、ワードプロセッシング、スプレッドシート、CSV と TSV、プレゼンテーション、メール、SVG、ファイナンス、3D ドキュメントのロードオプションで機能します。
信頼できないドキュメントに対する安全なデフォルト
誰かがアップロードしたファイルを変換する際に、サーバーが他のファイルを読み込んだり任意のホストにアクセスしたりしないようにします。デフォルト設定では、26.10 は次のように動作します:
- ドキュメント自身のフォルダー内のローカルファイルのみをロードし、UNC パスからは決してロードしません;
- HTML、MHTML、XHTML、SVG ドキュメント内のスクリプトは実行せず、スクリプトファイルも要求しません;
- 同じルールが SVG、3D モデル、XBRL、XSL‑FO、Markdown、メールからスプレッドシートへの変換にも適用されます。
ドキュメントが正当な理由で外部リソースを必要とする場合は、WhitelistedResources に信頼できる場所を列挙するか、ハンドラで個別に判断するか、SkipExternalResources = false を設定してください。スクリプトは WebLoadOptions または SvgLoadOptions の ExecuteScripts = true を設定したときだけ実行されます。UNC パスや javascript:、vbscript: の参照は設定に関係なくロードされません。
要求された出力
一部の変換ではリクエストの一部が無視されていました。DOCX、XLSX、PPTX、またはマルチフレーム TIFF が常に出力されていたり、メール、Web、マルチページ TIFF からワードプロセッシングへの変換、Word Flat OPC ドキュメント、Project から PS と PCL への変換でページ選択が無視されていました。これらはすべて、変換オプションで指定された形式とページ選択を正しく反映するようになりました。ウォーターマークは画像以外のドキュメントを画像に変換する際や CSV、TSV の変換時にも表示され、MHT と MHTML ページは MIME ソースではなくレンダリングされたページが出力されます。また、J2K、JP2、WMF、WMZ の出力で透明背景が黒くなる問題も解消されました。
失敗する変換の削減
.NET Framework 上で run または file 演算子を使用する PostScript、PSD、PSB、AI のページ単位変換、CAD 全体の TeX 変換、インライン SVG を含む XHTML、PDF、XPS、SVG から EPUB、Visio と SVG からスプレッドシートへの変換が、失敗せずに正常に変換されるようになりました。メール、メールボックス、アーカイブファイルにおいて、変換できない添付ファイルが全体の変換を失敗させることはなくなり、ロードできない埋め込みドキュメントは ConversionEvents.OnDocumentFailed を通じて報告されます。
セキュリティ、ライセンス、.NET Framework
System.Security.Cryptography.Pkcsが 8.0.2(.NET 10 では 10.0.13)に更新され、CVE‑2026‑84008 と CVE‑2026‑70162 に対応しました。- .NET Framework プロジェクトで
RuntimeInformationやValueTupleのロードが失敗しなくなり、EML、HTML、CAD の変換が .NET Framework 4.6.2 から 4.7.0 でも失敗しなくなりました。 - 正規のライセンスがある場合、WebP 変換でトライアルバッジが表示されなくなりました。評価モードでは、3 ページの制限が SVG、SVGZ、PS、PCL の出力にも適用されます。
このリリースの新機能
- [Feature] ドキュメントがロードする各外部リソースを検査、許可、拒否、または供給できるリソース単位のコールバックを追加
- [Improvement] SVG と SVGZ ドキュメント用のロードオプションとして
SvgLoadOptionsを提供 - [Improvement] 件名がない OLM と NSF アイテムにフォルダーと位置で名前を付け、メールボックスアイテム名で予約済み Windows デバイス名を回避
- [Improvement] アーカイブ、メール、メールボックスアイテムでロードできないものをドキュメント失敗ハンドラに報告し、単にログに記録するだけでなく
- [Bug] 有効なライセンスがあるにもかかわらず Webp 変換時にトライアルバッジが適用される問題
- [Bug] 特定の VSDX ファイル変換でテキストがボックスの境界外に出る問題
- [Bug] ODT から PDF への変換で二重取り消し線テキストが保持されない問題
- [Bug] VCF から Excel への変換問題
- [Bug] PackageReference を使用する旧式 .NET Framework 4.7.1+ プロジェクトで
RuntimeInformationのロードに失敗する変換を修正 - [Bug]
packages.configプロジェクトでRuntimeInformationまたはValueTupleのロードに失敗する変換を修正 - [Bug] .NET Framework 4.6.2 から 4.7.0 ランタイムで EML、HTML、CAD の変換が失敗する問題を修正
- [Bug] ワードプロセッシング、Pdf、ProjectManagement ドキュメントを任意のスプレッドシート形式に変換すると常に XLSX が生成される問題を修正
- [Bug] ワードプロセッシング、Pdf、Diagram ドキュメントを任意のプレゼンテーション形式に変換すると常に PPTX が生成される問題を修正
- [Bug] 件名がないアイテムや PST の付箋が読めないテキストになる問題で PST、OST、MBOX の変換が失敗する問題を修正
- [Bug] 1 ページドキュメントを非 TIFF 画像形式に変換すると常にマルチフレーム TIFF が生成される問題を修正
- [Bug] [GroupDocs.Conversion for .NET]
System.Security.Cryptography.Pkcsを 8.0.2 に更新(CVE‑2026‑84008 / CVE‑2026‑70162) - [Bug] 画像以外のドキュメントを画像に変換する際にテキストまたは画像のウォーターマークが適用されない問題
- [Bug] J2K、JP2、WMF、WMZ への変換で透明ページ背景が黒くなる問題
- [Bug] Word 系ドキュメントの WMZ 出力が gzip 圧縮された PNG を保持し、画像の EMZ 出力が二重に gzip 圧縮される問題
- [Bug] MHT と MHTML ページを画像に変換したときにページではなく MIME ソースが表示される問題
- [Bug] Publisher ドキュメントの情報で常に 1 ページと報告される問題
- [Bug] CSV と TSV ドキュメントの変換時にウォーターマークが適用されない問題
- [Bug] 外部リソースのロードを正確にホワイトリスト化された URL プレフィックスとドキュメント自身のフォルダーのみに制限し、UNC パスからは決してロードしないように修正
- [Bug] CAD、画像、Diagram、DjVu、VCF、Email からワードプロセッシングへの変換で DOC 以外はすべて DOCX が保存される問題を修正
- [Bug] Email からワードプロセッシングへの変換でページ選択とページ範囲が無視される問題を修正
- [Bug] マルチページ TIFF からワードプロセッシングへの変換でページ選択が無視される問題を修正
- [Bug] Markdown と CHM ドキュメントの変換時に
SkipExternalResourcesとWhitelistedResourcesを尊重するように修正 - [Bug] email‑to‑spreadsheet、スプレッドシート、ページ範囲変換時に
SkipExternalResourcesとWhitelistedResourcesを尊重するように修正 - [Bug] HTML をスプレッドシートに変換する際、デフォルトでドキュメントフォルダー外の画像をロードしないように修正
- [Bug] SVG をプレゼンテーション、ワードプロセッシング、スプレッドシート、XPS、EPS に変換する際、デフォルトで外部リソースをロードしないように修正
- [Bug] 3D ドキュメント変換時に、デフォルトでモデルフォルダー外のマテリアルライブラリ、テクスチャ、バッファをロードしないように修正
- [Bug] XML を XSL‑FO スタイルシート経由で変換する際、デフォルトで外部リソースをロードしないように修正
- [Bug] HTML と MHTML をワードプロセッシングに変換する際、すべてのターゲットで DOCX が保存される問題を修正
- [Bug] XBRL とインライン XBRL タクソノミーをドキュメントフォルダー外からロードしないようにデフォルトで設定
- [Bug] HTML、XHTML、SVG ドキュメント変換時にスクリプトの実行とスクリプトファイルのダウンロードを停止
- [Bug] Web からワードプロセッシングへの変換でページ選択とページ範囲が無視される問題を修正
- [Bug] Word Flat OPC ドキュメントでページ選択とページ範囲が無視される問題を修正
- [Bug] 3D ドキュメント変換時に、デフォルトでモデルフォルダー外のテクスチャを埋め込まないように修正
- [Bug] 名前なしファイルで単一ストリーム圧縮アーカイブが変換される問題を修正
- [Bug] 外部リソースが許可されている場合に
javascript:とvbscript:参照が取得される問題を修正 - [Bug] インライン SVG を含む XHTML ドキュメントの変換失敗を修正
- [Bug] 相対 CSS @import がロードできない場合に HTML から HTML への変換が失敗する問題を修正
- [Bug] 描画対象がないページで Visio と SVG のスプレッドシート変換が失敗する問題を修正
- [Bug] ハイパーリンクがテキストをカバーしていない場合に PDF、XPS、SVG から EPUB への変換が失敗する問題を修正
- [Bug] 変換先フォーマットに変換できない添付ファイルがある場合にメール、メールボックス、アーカイブ変換が失敗する問題を修正
- [Bug] PDF が変換された後に PCL 変換で Courier New や他のインストール済みフォントが置き換えられる問題を修正
- [Bug] GroupDocs.Conversion.LowCode 26.9.0:Linux 上の DOCX から PDF 変換でフォント置換が無視され、アルファベット順の最初のフォントが使用される問題
- [Bug] GroupDocs.Conversion.LowCode 26.9.0 の XML ドキュメントエラーを修正
- [Bug] .NET Framework 上で run または file 演算子を使用する PostScript 変換が失敗する問題を修正
- [Bug] ライセンスなしでページ記述言語フォーマットに変換する際にトライアルページ制限が無視される問題を修正
- [Bug] PSD、PSB、Illustrator AI ドキュメントのページ単位変換が例外で失敗する問題を修正
- [Bug] ビデオをオーディオ形式に変換する際、ビデオコネクタが設定されていても失敗する問題を修正
- [Bug] ProjectManagement から PS と PCL への変換で余分なページが生成され、ページ選択が無視される問題を修正
- [Bug] ProjectManagement から SVG への変換で UTF‑16 がバイトオーダーマークなしで書き込まれる問題を修正
- [Bug] 3D から glTF と OBJ への変換でバッファとマテリアルファイルが作業ディレクトリに書き込まれる問題を修正
- [Bug] MHT と MHTML の PDF、XPS、TeX、ワードプロセッシングへの変換でページではなく MIME ソースが表示される問題を修正
- [Bug] CAD から TeX への変換で全体の図面が
FileTypeNotSupportedで失敗する問題を修正 - [Bug] PDL と XML/JSON から PS と PCL への変換で余分なページが追加される問題を修正
- [Bug] CAD から PS と PCL への変換でマルチページ DWF 図面が 1 ページしか保持されない問題を修正
- [Bug] メッセージの件名がファイル名のように見える場合に MBOX 変換が失敗したりメールヘッダーが失われる問題を修正
パブリック API の変更
新しい API
GroupDocs.Conversion.Options.Load名前空間にIExternalResourceHandlerとExternalResourceLoadingArgs(Uri、Skipped、Data)を追加IResourceLoadingOptionsとそれを実装するロードオプションにExternalResourceHandlerを追加WebLoadOptionsとSvgLoadOptionsにExecuteScriptsを追加FinanceLoadOptionsとThreeDLoadOptionsにSkipExternalResources、WhitelistedResources、ExternalResourceHandlerを追加し、これらはIResourceLoadingOptionsを実装
⚠️ アップグレード前の確認事項
-
外部リソース: フォルダー外のローカルファイル、UNC パス、スクリプトに依存していたドキュメントは、これらが無い状態で変換されます。信頼できるリソースだけを許可する方法は、信頼できないドキュメントに対する安全なデフォルト を参照してください。
-
ホワイトリストエントリ: 各
WhitelistedResourcesエントリは絶対 URI プレフィックスである必要があります(例:https://cdn.example.com/assets/またはfile:///C:/assets/)。jpgやexample.comのように以前のバージョンで URL の任意の位置にマッチしていたものは、InvalidLoadOptionsExceptionによりロードが失敗します。 -
XBRL とインライン XBRL: タクソノミーがフォルダー外にある、またはストリームからロードされた申告書は
InvalidLoadOptionsExceptionでロードが失敗します。信頼できる申告書は次のようにロードしてください:using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false })) { converter.Convert("filing.xlsx", new SpreadsheetConvertOptions()); } -
SVG と SVGZ: ロードオプションなしで変換すると、現在は
SvgLoadOptionsが使用され、PossibleConversions.LoadOptionsはPageDescriptionLanguageLoadOptionsの代わりにSvgLoadOptionsを返します。 -
出力形式とページ: 変換は要求された形式とページ選択を尊重するようになったため、同じオプションでも以前のバージョンとは異なる出力になる可能性があります。
PublisherDocumentInfo.PagesCountは実際のページ数を返すようになりました。 -
カスタム
IResourceLoadingOptions実装: 新しいExternalResourceHandlerプロパティを追加する必要があります。
リリースノート では、例外メッセージを含むすべての変更が一覧化されています。
アップデートの取得方法
NuGet
NuGet から最新の GroupDocs.Conversion パッケージにアップグレードしてください: GroupDocs.Conversion 26.10.0
dotnet add package GroupDocs.Conversion --version 26.10.0
直接ダウンロード
GroupDocs.Conversion for .NET 26.10 ページからアセンブリをダウンロード
リソース
- 完全なリリースノート
- ドキュメント
- ネットワークアクセスとデータプライバシー – ライブラリがネットワークにアクセスするタイミングとオフライン実行方法
- 外部リソースのロードをスキップする – デフォルト、ホワイトリストエントリ、リソース単位ハンドラ、スクリプト
- マイグレーションノート – 26.10 への移行手順
- 各種ドキュメントタイプのロードオプション
- GitHub サンプル – 信頼できる場所、リソース単位ハンドラ、信頼できる HTML とリモートタクソノミーを持つ XBRL の例
- Free Support Forum