HTML ファイルは、インターネット上で情報共有のために広く使用されています。このファイルは大多数のプラットフォームでサポートされており、ほぼすべての Web ブラウザーでこの形式を読み込むことができるため、許容される形式の 1 つとなっています。ただし、広く受け入れられているため、多くのハッカーが HTML ファイル内に悪意のあるスクリプトを埋め込もうとします。悪意のある HTML および JavaScript コードによる注目度の高い攻撃は、近年、認知度と悪用度の両方で劇的な増加が見られます。一方、XPS ファイルは、XML Paper Specifications に基づくページ レイアウト ファイルを表します。
- XPS は PDF ファイル形式に似ていますが、ドキュメントのレイアウト、外観、印刷情報に XML を使用します。
HTML 変換 API
Aspose.HTML Cloud は、HTML ファイルを処理する機能を提供するために特別に設計されています。入力 HTML の他に、XHTML、MHTML、EPUB、Markdown、または URL で Web ページを読み込むこともできます。結果の出力は、PDF、XPS、DOCX、またはラスター イメージ形式 (JPEG、PNG、TIFF、BMP、GIF) になります。API は REST アーキテクチャに従って開発されているため、デスクトップ、モバイル、Web、ハイブリッド アプリケーション、およびデスクトップまたはモバイル プラットフォームで使用できます。
お客様の利便性をさらに高めるために、プログラミング言語固有の SDK を作成しました。クラウド SDK は、さまざまなプログラミング言語の REST API のラッパーであり、任意の言語でドキュメントを処理できます。これにより、強力な型と IDE のハイライトのすべての利点を迅速かつ簡単に得ることができます。すぐに開始できるように、SDK と実際の例については Aspose.HTML GitHub リポジトリ を確認してください。この記事では、Aspose.HTML Cloud SDK for .NET のドキュメント変換機能について説明します。
インストール
Cloud SDKの使用を開始するには、まずシステムにインストールする必要があります。SDKはNuGetとGitHubから入手できます。ターミナルウィンドウで次のコマンドを実行して、NuGetのインストールを実行してください。
nuget install Aspose.HTML-Cloud
もう 1 つのオプションは、Visual Studio 内のパッケージ マネージャー コンソールを使用して SDK をインストールすることです。次のコマンドを実行してください。
PM> Install-Package Aspose.HTML-Cloud
NuGet パッケージ マネージャー
もう 1 つの最も簡単な方法は、Visual Studio IDE 内の NuGet パッケージ マネージャーを使用して SDK をインストールすることです。
- ソリューション エクスプローラーを開きます。
- プロジェクトを展開し、ソリューション内のパッケージ フォルダーを右クリックします。
- 「NuGet パッケージの管理…」オプションを選択します。
- [参照] タブをクリックし、「Aspose.HTML-Cloud」を検索します。
- Aspose.HTML-Cloud パッケージをクリックし、右側のタブで適切なバージョンを選択して、「パッケージの追加」ボタンをクリックします。
無料クラウドサブスクリプション
次の重要なステップは、Aspose.Cloud ダッシュボード での無料アカウント サブスクリプションです。クレジットカードやその他の支払い情報は必要ありません。GitHub または Google アカウントをお持ちの場合は、サインアップするか、新しいアカウントの作成 ボタンをクリックして必要な情報を入力します。資格情報を使用してダッシュボードにログインし、ダッシュボードからアプリケーション セクションを展開して、クライアント資格情報セクションまで下にスクロールして、クライアント ID とクライアント シークレットの詳細を確認します。
C# で HTML を XPS に変換する
このセクションでは、次の 2 つのシナリオで HTML ファイルを XPS 形式に変換する方法について説明します。
クラウドストレージからHTMLを読み込む
以下の手順に従って、HTML ファイルをクラウド ストレージにアップロードし、XPS 形式への変換を実行してください。
- まず、ClientID と ClientSecret の詳細を引数として渡しながら、HtmlApi インスタンスを作成してください。
- 次に、File.OpenRead(…) メソッドを使用して HTML ファイルを読み取ります。
- 3 番目に、StorageApi のインスタンスを作成し、UploadFile(…) メソッドを使用して HTML ファイルをクラウド ストレージにアップロードします。
- 最後に、PutConvertDocumentToXps(…) メソッドを呼び出して HTML から XPS への変換を実行し、結果の XPS をクラウド ストレージに保存します。
// https://dashboard.aspose.cloud/ から ClientID を取得します。
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// ベースURL文字列
const string SERVICE_API_HOST = "https://api.aspose.cloud";
// HtmlApiインスタンスを作成する
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret,SERVICE_API_HOST);
String name = "inputHTML.html";// inpit Document name.
int width = 800; // Resulting image width.
int height = 1000; // Resulting image height.
int leftMargin = 10; // Left resulting image margin.
int rightMargin = 10; // Right resulting image margin.
int topMargin = 10; // Top resulting image margin.
int bottomMargin = 10; // Bottom resulting image margin.
// 結果ファイルの名前
string resultantFile = "Resultant.xps";
try
{
// ローカルドライブからファイルを読み込む
using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
{
// StorageApiインスタンスを作成する
var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
// HTMLファイルをクラウドストレージにアップロードする
uploadFileRequest.UploadFile(file, "inputHTML.html");
}
// PDF形式への変換を実行する
// 出力をクラウドストレージに保存する
AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
name, resultantFile, width, height,
leftMargin, rightMargin, topMargin, bottomMargin);
// 変換が成功した場合は成功メッセージを出力します
if (response != null && response.Equals("OK"))
{
Console.WriteLine("HTML successfully converted to XPS !");
}
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
テスト目的で、入力HTMLと結果のXPSはinputHTML.htmlとResultant.xpsからダウンロードできます。
cURL を使用して HTML を XPS に変換する
当社の API は REST アーキテクチャに従って開発されているため、cURL コマンド経由でもアクセスできます。このセクションでは、cURL コマンドを使用して HTML ページを XPS 形式に変換する方法について説明します。ただし、先に進む前に、まず Aspose.Cloud ダッシュボード のクライアント資格情報に基づいて JSON Web トークン (JWT) を作成します。HTML から XPS への変換を実行するには、以下の手順に従ってください。
- クラウド ダッシュボードからクライアント ID とクライアント シークレットを取得します。
- クライアントの資格情報に基づいて JSON Web アクセス トークンを取得します。
- PutConvertDocumentToXps APIを呼び出します。
- 生成された PDF ファイルはクラウド ストレージに保存されます。
JWT アクセス トークンを生成するには、次の cURL コマンドを実行してください。
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
HTML ファイルをクラウド ストレージにアップロードするには、次のコマンドを実行してください。
curl -X PUT "https://api.aspose.cloud/html/storage/file/inputHTML.html" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: multipart/form-data" \
-d {"File":{}}
HTML をクラウド ストレージにアップロードした後、次のコマンドを使用して HTML から XPS への変換を実行し、結果のファイルをクラウド ストレージに保存できます。
curl -X PUT "https://api.aspose.cloud/html/inputHTML.html/convert/xps?outPath=converted.xps&width=800&height=1000&leftMargin=10&rightMargin=10&topMargin=10&bottomMargin=10" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
無料のXPSビューア
XPSファイルを表示するには、XPS Viewer Appの使用を検討してください。これはREST APIをベースに開発されており、APIの素晴らしい機能を体験することができます。
結論
HTMLファイルを固定ページレイアウトやその他のラスターイメージに変換するAspose.HTML Cloudの機能について説明しました。C# .NETコードスニペットとcURLコマンドを使用してHTMLを変換する機能について説明しました。
ただし、Aspose.HTML Cloud のラッパーである Aspose.HTML Cloud SDK for .NET は MIT ライセンスの下で開発されているため、完全なコード スニペットは GitHub からダウンロードできます。API の使用中に問題が発生した場合は、無料製品サポート フォーラム からお気軽にお問い合わせください。
関連記事
詳細については、以下のリンクをご覧ください。