C# 向け HTML 文書処理 API – Aspose.HTML for .NET

.NET アプリケーションで HTML の解析、DOM の編集、Web 文書の変換、出力ファイルの生成を行えます。

C# で HTML を解析、編集、変換

Aspose.HTML for .NET は、C# アプリケーションで HTML コンテンツを処理するためのクラスライブラリです。 HTMLDocument クラスは、ファイル、URL、文字列、またはストリームから HTML を読み込み、標準仕様に準拠した DOM を介して文書へアクセスできるようにします。アプリケーションでは、要素の検索と編集、CSS、SVG、HTML Canvas の操作に加え、 Converter クラスを使用した PDF、XPS、DOCX、ラスター画像の生成が可能です。この API は XHTML、MHTML、EPUB、Markdown にも対応します。

HTML で行う処理を選択

アプリケーションに合う処理を選択してください。各ガイドでは、関連する API クラス、目的を絞った C# サンプル、詳細なドキュメントと API Reference へのリンクを提供します。

HTML 文書の作成と読み込み
マークアップまたは DOM ノードから文書を作成し、ファイル、URL、文字列、ストリームから HTML を読み込みます。

HTML 要素の検索と抽出
CSS セレクターまたは XPath クエリでコンテンツを検索し、一致する DOM ノードを C# で読み取ります。

Web 文書の編集
HTML、MHTML、Markdown の要素、属性、テキスト、スタイル、リンクされたリソースを変更します。

HTML を出力形式に変換
HTML と XHTML を PDF、XPS、DOCX、TIFF、PNG、JPEG などの対応形式に変換します。

EPUB、MHTML、Markdown、SVG を変換
各 Web 形式または出版形式に適した変換メソッドと保存オプションを使用します。

Web 文書を結合
複数の HTML、MHTML、EPUB、Markdown ソースを指定した順序で 1 つの文書に結合します。

HTML コードを生成
オンラインサンプルで、フォーム、メディア、表、リンク、インタラクティブ要素、セマンティックテキストのマークアップを作成します。

newWeb アクセシビリティを検証
WCAG ルール、カラーコントラスト、画像の代替テキストを確認し、検証結果をエクスポートします。

HTML 内の画像を管理
文書の構造とその他のコンテンツを維持しながら、画像の追加、削除、サイズ変更、抽出を行います。

HTML 表の作成と編集
DOM API で表を作成し、行やセルを抽出するほか、既存の表の内容を C# で更新します。

HTML テンプレートにデータを設定
HTML テンプレートと XML または JSON データを組み合わせ、再利用可能なレイアウトから文書を生成します。

HTML Canvas 2D で描画
Canvas 2D API で図形、テキスト、パス、画像を描画し、その結果を文書とともにレンダリングします。

CSS の長さ単位を変換
`Unit` API を使用して、C# の計算で CSS ピクセル、センチメートル、ミリメートルを変換します。

newLinux でクロスプラットフォーム描画
Linux アプリケーションで System.Drawing.Common を使わずに描画する場合は、Aspose.HTML.Drawing パッケージを追加します。

Aspose.HTML for .NET のインストール

Aspose.HTML NuGet パッケージを .NET プロジェクトに追加します。このパッケージには、本サイトのサンプルやガイドで使用する HTML DOM、CSS、レンダリング、変換、文書処理の名前空間が含まれます。

.NET CLI で Aspose.HTML をインストール



dotnet add package Aspose.HTML

C# で HTML 要素を検索する方法

HTMLDocument で HTML ファイルを読み込み、 QuerySelectorAll() で一致する要素を検索して、DOM から各結果を読み取ります。このサンプルでは Aspose.HTML for .NET の型を明示しており、NuGet パッケージのインストール後にコンソールアプリケーションで実行できます。

C# で HTML 要素を検索



using Aspose.Html;
using Aspose.Html.Collections;
using Aspose.Html.Dom;

// Load the HTML document
using HTMLDocument document = new HTMLDocument("input.html");

// Select every link in the document
NodeList links = document.QuerySelectorAll("a");

foreach (Element link in links)
{
    Console.WriteLine($"{link.TextContent}: {link.GetAttribute("href")}");
}

QuerySelectorAll("a") は、文書内の順序で一致するすべての <a> 要素を格納した NodeList を返します。最初に一致する要素だけが必要な場合は QuerySelector()、XPath 式を使用する場合は XPath クエリを使用します。

対応する Web 形式と出力形式

入力または文書形式	利用可能な処理
HTML と XHTML	解析、作成、編集、ナビゲーション、結合、変換、レンダリング
MHTML と MHT	アーカイブの読み込み、変換、レンダリング、結合、更新済みアーカイブの作成
EPUB	出版物の読み込み、コンテンツの結合、固定レイアウト形式または画像へのレンダリング
Markdown	解析、作成、編集、HTML への変換、HTML 文書を介したレンダリング
SVG	ベクターコンテンツの読み込み、確認、編集、変換

ソース形式に応じて、変換処理では PDF、XPS、DOCX、TIFF、PNG、JPEG、BMP、GIF ファイルを生成できます。適切な Converter メソッドと保存オプションクラスの選択方法については、 Converting Between Formats を参照してください。

HTML API クラスと開発者向けリソース

HTMLDocument は、読み込まれた HTML 文書または新しく作成された HTML 文書を表し、DOM へのアクセスを提供します。
QuerySelector() と QuerySelectorAll() は、CSS セレクターで要素を検索します。
Converter は、HTML、XHTML、MHTML、EPUB、Markdown、SVG を変換する静的メソッドを提供します。
PdfSaveOptions 、DocSaveOptions、ImageSaveOptions、XpsSaveOptions は、形式ごとの出力を設定します。

Getting Started から始めるか、完全な Aspose.HTML for .NET API Reference を参照し、 Aspose.HTML for .NET GitHub リポジトリの実行可能なサンプルを確認してください。

よくある質問

1. C# で HTML 文書を読み込んだ後に何ができますか？

HTML を HTMLDocument に読み込んだ後、DOM の調査、CSS セレクターまたは XPath による要素の検索、コンテンツや属性の変更、ノードの追加や削除、更新した文書の保存や変換を行えます。

2. PDF や画像に変換する前に HTML を変更できますか？

はい。ソースを HTMLDocument に読み込み、DOM、CSS、リンクされたコンテンツを変更してから、更新した文書を必要な変換メソッドに渡します。生成される PDF、XPS、DOCX、画像ファイルには変更が反映されます。

3. HTML の読み込み時に CSS、画像、フォントの相対 URL はどのように解決されますか？

リソースの相対 URL は、文書のアドレスまたは HTML の読み込み時に指定したベース URL を基準に解決されます。マークアップを文字列やストリームから読み込み、外部リソースを参照する場合は、正しいベース URL が特に重要です。

4. HTML、MHTML、EPUB、Markdown、SVG の変換にはどの API メソッドを使用しますか？

変換には、ConvertHTML()、ConvertMHTML()、ConvertEPUB()、ConvertMarkdown()、ConvertSVG() など、ソース形式に対応する Converter クラスのメソッドを使用します。保存オプションクラスによって出力形式と変換設定が決まります。