C# .NET で HTML を PDF に変換する

効率的なドキュメント管理ソリューションの需要は飛躍的に高まり続けています。この記事では、HTML から PDF への変換に .NET Cloud API を活用するメリットと実用的なアプリケーションについて詳しく説明します。ワークフローの合理化からさまざまなプラットフォーム間の互換性の確保まで、この機能によって生産性が大幅に向上し、ドキュメント管理タスクが簡素化される仕組みについて説明します。

この記事では以下のトピックを取り上げます。

HTML から PDF への変換 API

ここでは、GroupDocs.Conversion Cloud SDK for .NET の強力な機能と、HTML から PDF への変換要件をシームレスに達成する上でのその重要な役割について説明します。企業や開発者がドキュメント管理の効率的なソリューションを求めている中、この API は、比類のない使いやすさと汎用性を提供する強力なツールとして登場しました。この変換 SDK によって、HTML ファイルを PDF 形式に簡単に変換し、ワークフローをスムーズにして生産性を向上させる方法について詳しく説明します。

さて、SDK を使用するには、まずインストールする必要があります。NuGet パッケージ マネージャーで GroupDocs.Conversion-Cloud を検索し、[インストール] ボタンをクリックするだけです。別の方法としては、パッケージ マネージャー コンソールで次のコマンドを実行します。

NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0

REST API が正常にインストールされたら、API 資格情報 (クライアント ID とクライアント シークレット) があることを確認してください。API 資格情報の取得方法については、この短い チュートリアル を参照してください。

C# .NET を使用して HTML を PDF に変換する

このセクションでは、C# .NET を使用してプログラムで HTML を PDF に変換する方法について詳しく説明します。

  1. クライアントの資格情報を引数として渡す Configuration クラスのインスタンスを作成します。
var configurations = new Configuration(clientId, clientSecret1);
  1. ConvertApi を初期化し、Configuration オブジェクトを入力引数として渡します。
var apiInstance = new ConvertApi(configurations);
  1. 入力 HTML ファイルをクラウド ストレージにアップロードします。ここで、入力 HTML ファイルの名前を指定します。
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
  1. 入力 HTML の名前、出力形式を pdf、結果の PDF ドキュメントの名前を指定して、インスタンス ConvertSettings を作成します。
var settings = new ConvertSettings{...}
  1. ConvertDocumentRequest APIを呼び出してHTMLをPDF形式に変換します。変換が成功すると、結果のPDFはクラウドストレージに保存されます。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// さらなる例は https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet をご覧ください。
// API認証情報を取得する 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// Configuration クラスのインスタンスを作成し、クライアント ID とクライアント シークレットを使用して初期化します。 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// ApiBaseUrl の値を定義して、html から PDF へのコンバーター API のベース URL を設定します。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Configuration クラスのオブジェクトを使用して ConvertApi クラスのインスタンスを初期化します。
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// ローカルドライブからHTMLファイルを読み込む             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // FileApiのインスタンスを作成する
    var fileUpload = new FileApi(configurations);
    // 入力HTMLファイルをクラウドストレージにアップロードする
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // 入力HTMLと結果PDFの名前を定義するConvertSettingsを作成します。
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // プログラムによって HTML を PDF に変換するには、ConvertDocument メソッドを呼び出します。
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // 成功メッセージを印刷する
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
HTML から PDF への変換のプレビュー。

画像: HTML から PDF への変換のプレビュー。

上記の例で生成されたサンプルPDFはresultant.pdfからダウンロードできます。

cURL コマンドを使用した HTML から PDF への変換

HTML を PDF に変換するもう 1 つのオプションは、GroupDocs.Conversion Cloud と cURL コマンドの組み合わせです。GroupDocs.Conversion Cloud で cURL コマンドを使用して HTML を PDF に変換すると、HTML ファイルを PDF 形式に変換するシームレスで簡単な方法が提供され、複雑な手動プロセスが不要になるなど、いくつかの注目すべき利点があります。したがって、GroupDocs.Conversion Cloud API を活用することで、ユーザーは変換プロセスを自動化し、反復的なタスクにかかる時間と労力を節約できます。

GroupDocs ダッシュボードから API 認証情報 (アプリ キーとアプリ SID) を取得し、JWT アクセス トークンを生成していることを確認します。JWT トークンを取得したら、次の cURL コマンドを実行してください。ここでは、この変換プロセス中に追加されるテキスト ウォーターマークのプロパティも提供しています。

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"GroupDocs.Cloud\",      \"FontName\": \"Arial\",      \"FontSize\": 4,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"olive\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

sourceFile を入力 HTML ファイルの名前に、resultantFile を生成した出力 PDF 形式の名前に、accessToken を上記で生成した JWT トークンに置き換えてください。

無料の HTML から PDF への変換アプリ

GroupDocs.Conversion Cloud API に基づいて、オンラインの HTML to PDF Converter を開発しました。これは、無料で軽量、超効率的で、堅牢な HTML から PDF への変換を提供します。

無料の HTML から PDF へのアプリ

便利なリンク

結論

GroupDocs.Conversion Cloud は、ドキュメント変換タスクにシームレスで効率的、かつ信頼性の高いソリューションを提供し、ワークフローを合理化して生産性を向上させることができることがわかりました。そのため、GroupDocs.Conversion Cloud API は、変換プロセスを自動化し、結果の一貫性と正確性を確保することで、複雑なタスクを簡素化し、貴重な時間とリソースを節約します。したがって、ドキュメント変換機能をアプリケーションに統合しようとしている開発者でも、ドキュメント管理プロセスを最適化しようとしている企業でも、当社の API は成功に必要なツールを提供します。

関連記事

詳細については、次のリンクにアクセスすることを強くお勧めします。