HTML、MHTML、EPUB、Markdownを結合するAPI
複数のソースファイルをC#で処理し、1つの出力ドキュメントとしてレンダリングします。
C#でHTML、MHTML、EPUB、Markdownファイルを結合
Aspose.HTML for .NET
は、同じ種類の複数のソースファイルを1つのレンダリング済みドキュメントにまとめます。HTMLでは、
HTMLDocument
オブジェクトを
HtmlRenderer
に渡します。MHTMLまたはMHTアーカイブでは、ストリームを
MhtmlRenderer
に渡し、EPUB出版物では
EpubRenderer
を使用します。Markdownファイルは、最初に
Converter.ConvertMarkdown()
でHTMLDocumentオブジェクトに変換してから、HtmlRendererで処理します。どのワークフローでも、ソースの順序がコンテンツの順序を、出力デバイスが対象形式を決定します。
ファイル結合ワークフローを選択
| ソースファイル | C#でのソース表現 | レンダラー | 詳細ガイド |
|---|---|---|---|
| HTML | HTMLDocument | HtmlRenderer | HTML結合 |
| MHTMLまたはMHT | Stream | MhtmlRenderer | MHTML結合 |
| EPUB | Stream | EpubRenderer | EPUB結合 |
| MarkdownまたはMD | Converter.ConvertMarkdown()が返すHTMLDocument | HtmlRenderer | Markdown結合 |
C#によるHTML結合とインタラクティブな例
このハブの例ではHTMLワークフローを示します。ローカルHTMLファイルまたはURLを必要な順序で追加し、PDF、XPS、DOCX、TIFF、またはMHTMLを選択します。レンダラーを使用する出力では、現在の選択に合わせてC#パネルのドキュメント宣言、出力デバイス、拡張子が更新されます。設定した結合をオンラインで実行して結果を確認するか、生成されたコードを.NETプロジェクトにコピーできます。HTML固有のリソース処理と制限については、 HTML結合ガイド を参照してください。
using Aspose.Html;
using Aspose.Html.Rendering;
using Aspose.Html.Rendering.Pdf;
// Load the HTML documents in the required merge order.
using HTMLDocument document1 = new HTMLDocument("first.html");
using HTMLDocument document2 = new HTMLDocument("second.html");
// Create the renderer and the PDF output device.
using HtmlRenderer renderer = new HtmlRenderer();
using PdfDevice device = new PdfDevice("merged.pdf");
// Render the sources into one PDF file.
renderer.Render(device, document1, document2);
出力デバイスを選択
PdfDeviceは、配布、アーカイブ、印刷用のPDFを作成します。XpsDeviceは、レンダリングしたソースをXPSドキュメントに書き込みます。DocDeviceは、Microsoft Wordなどの対応エディターで開けるDOCXドキュメントを作成します。ImageDeviceとImageRenderingOptionsは、TIFFまたは対応する他のラスター形式を生成します。
各デバイスには、ページサイズ、余白、解像度など対象形式固有の設定を指定するレンダリングオプションクラスがあります。利用できるデバイスとコンストラクターについては、 C#のレンダリングデバイス を参照してください。
インタラクティブなHTML結合ツールでは、MHTML Webアーカイブも作成できます。
Aspose.HTML for .NET のインストール
.NET CLI を使用して、NuGet から Aspose.HTML for .NET をインストールします。
dotnet add package Aspose.HTML
NuGet パッケージ マネージャーの UI を使用するか、パッケージ マネージャー コンソールで Install-Package Aspose.HTML を実行することもできます。セットアップの詳細は
インストール ガイド
を参照してください。評価制限なしで API を試すには、
一時ライセンス
を申請できます。
ファイル結合APIのFAQ
1. 1つのレンダラーですべてのソース形式を処理できますか?
いいえ。HTMLDocumentオブジェクトにはHtmlRenderer、MHTMLまたはMHTストリームにはMhtmlRenderer、EPUBストリームにはEpubRendererを使用します。MarkdownはConverter.ConvertMarkdown()でHTMLDocumentに変換してから、HtmlRendererで処理します。
2. 結合後のファイルはソース形式で編集できますか?
いいえ。レンダラーは複数のソースを出力デバイスに渡し、PDF、XPS、DOCX、またはラスター出力を作成します。HTML DOMツリー、MHTML MIME構造、EPUBパッケージ、Markdownテキストを新しいソースファイルに統合する処理ではありません。
3. 異なるソース形式を同じレンダリング呼び出しに渡せますか?
いいえ。レンダラーは、HTMLDocumentオブジェクトやアーカイブストリームなど、1種類のソース表現を受け取ります。ソースに対応するワークフローを使用するか、別の処理で入力をあらかじめ正規化してください。
4. 結合結果内のコンテンツ順序は何で決まりますか?
ソースをRender()に渡す順序が出力内の位置を決定します。最終的なPDF、XPS、DOCX、またはTIFFで別の順序が必要な場合は、呼び出し前にドキュメントまたはストリームを並べ替えます。
5. 結合した出力をストリームに書き込めますか?
はい。PdfDeviceなどの出力デバイスは、ストリームベースの出力先を受け取れます。ICreateStreamProviderを使用すると、出力ストリームの作成と解放を制御できます。レンダリングが完了するまで出力先を利用可能な状態に保ってください。
Aspose.HTML for .NETのその他の機能
変換、編集、コード生成、Webアクセシビリティ向けのツールとAPIガイドをご覧ください。