C#によるMHTML結合の仕組み
Aspose.HTML for .NET
は、1つのMhtmlRendererで複数のMHTMLまたはMHTアーカイブストリームをレンダリングし、そのコンテンツを共通の出力デバイスへ書き込みます。必要な順序でストリームをMhtmlRenderer.Render()に渡すと、1つのPDF、XPS、DOCX、またはTIFFを作成できます。このワークフローはアーカイブのレンダリング済みコンテンツをまとめるものであり、編集可能な新しいMHTMLアーカイブを作成するものではありません。
C#によるMHTML結合とインタラクティブな例
インタラクティブな例でアーカイブの順序を設定し、それに対応するC#ワークフローを生成できます。MHTMLまたはMHTファイルを必要な順序で追加し、PDF、XPS、DOCX、またはTIFFを選択します。選択を変更すると、コードパネルのファイル名、レンダラー、出力デバイス、拡張子が更新されます。設定した結合をオンラインで実行して結果を確認することもできます。
using System.IO;
using Aspose.Html.Rendering;
using Aspose.Html.Rendering.Pdf;
// Open the MHTML files as streams in the required merge order.
using FileStream stream1 = File.OpenRead("first.mhtml");
using FileStream stream2 = File.OpenRead("second.mhtml");
// Create the renderer and the PDF output device.
using MhtmlRenderer renderer = new MhtmlRenderer();
using PdfDevice device = new PdfDevice("merged.pdf");
// Render the sources into one PDF file.
renderer.Render(device, stream1, stream2);
MHTMLファイルを結合するワークフロー
既定ではPDFが選択されています。レンダラーはMhtmlRendererのままで、出力デバイスは選択した対象形式に応じて変わります。
- 各
.mhtmlまたは.mhtソースファイルをFile.OpenRead()で開くか、読み取り可能な別のStream実装を指定します。 - レンダリング済みコンテンツを表示する順序にストリームを並べます。
MhtmlRendererインスタンスを作成します。- PDF用の
PdfDeviceなど、出力デバイスを作成します。 - デバイスとすべてのアーカイブストリームを
MhtmlRenderer.Render()に渡します。
MHTML結合の出力形式を選択
- PDF – 配布または印刷用の固定レイアウトドキュメントを作成します。
- XPS – WebアーカイブをXPSドキュメントとしてレンダリングします。
- DOCX – Microsoft Wordなどの対応エディターで開けるドキュメントを作成します。
- TIFF – 結合してレンダリングしたページをラスター画像として保存します。
生成されるC#コードは、対象形式に応じてPdfDevice、XpsDevice、DocDevice、またはImageDeviceを選択します。ページ、画像、ドキュメントの設定については、
C#のレンダリングデバイス
を参照してください。
MHTMLファイル結合時の注意点
- ソースの順序が結果の順序を決定します。 アーカイブは、ストリームを
MhtmlRenderer.Render()に渡した順序でレンダリングされます。 - 各入力ストリームを開いたままにしてください。 レンダラーが結合出力の書き込みを完了する前にストリームを破棄しないでください。
- 結果は新しいMHTMLアーカイブではありません。 MIMEパートは解釈およびレンダリングされますが、編集可能な別のWebアーカイブに統合されるわけではありません。
- レイアウト設定は出力デバイスに属します。 対応するレンダリングオプションクラスで、ページサイズ、余白、解像度など対象固有のオプションを設定します。
Aspose.HTML for .NET のインストール
.NET CLI を使用して、NuGet から Aspose.HTML for .NET をインストールします。
dotnet add package Aspose.HTML
NuGet パッケージ マネージャーの UI を使用するか、パッケージ マネージャー コンソールで Install-Package Aspose.HTML を実行することもできます。セットアップの詳細は
インストール ガイド
を参照してください。評価制限なしで API を試すには、
一時ライセンス
を申請できます。
MHTMLファイル結合のFAQ
1. 入力ファイルのMHTMLとMHTに違いはありますか?
MHTMLとMHTは、同じMIME HTML Webアーカイブ形式で一般的に使われる拡張子です。MIME構造と参照されるパートが有効であれば、MhtmlRendererはどちらのストリームも同じワークフローで処理します。
2. MHTMLレンダリングの実行時間を制限できますか?
はい。TimeSpanまたはCancellationTokenを受け取るMhtmlRenderer.Render()オーバーロードを使用します。アーカイブに複雑なページ、スクリプト、リソースが含まれ、処理が遅延する可能性がある場合に制限が役立ちます。
3. 埋め込まれた画像、スタイル、フォントは出力に含まれますか?
レンダラーは、アーカイブされたページが参照する有効なMIMEパートを使用します。パートの欠落、不正なContent-Location、利用できない外部リソースがあると、スタイル、画像、フォントが出力に含まれない場合があります。
4. HTMLドキュメントとMHTMLストリームを同じレンダリング呼び出しに渡せますか?
いいえ。MhtmlRendererはMHTMLストリームを、HtmlRendererはHTMLDocumentオブジェクトを受け取ります。ソースに対応するレンダラーを使用するか、別のワークフローで入力をあらかじめ正規化してください。
5. 結合したPDFをストリームへ書き込めますか?
はい。書き込み可能なStreamを使用してPdfDeviceを作成し、デバイスとMHTMLストリームをMhtmlRenderer.Render()に渡します。アプリケーションで後から結果を読み取るか転送する場合は、レンダリングが完了するまで出力ストリームを開いたままにしてください。