Installing wkhtmltopdf for C#

1. 公式ウェブサイトの URL から Windows 用の最新バージョンをダウンロードします: wkhtmltopdf Downloads
2. ダウンロードしたインストーラーをダブルクリックし、インストールウィザードに従って wkhtmltopdf をインストールします。

3. インストールが完了したら、wkhtmltopdf 実行可能ファイルをシステムの PATH 環境変数に追加してパスを変更します。 これは、次のコマンドを使用してコマンドプロンプト経由で実行できます:

   set PATH=%PATH%;C:\Program Files\wkhtmltopdf\bin

   set PATH=%PATH%;C:\Program Files\wkhtmltopdf\bin

   SHELL

Java 用の wkhtmltopdf のインストール

1. 公式ウェブサイトから Windows 用の最新の wkhtmltopdf バージョンをダウンロードします: wkhtmltopdf Downloads
2. ダウンロードしたアーカイブの内容をシステム上の宛先フォルダーに抽出します。

C#とJavaの両方で、wkhtmltopdfのインストールと使用には、コマンドプロンプトからwkhtmltopdfコマンドを実行するか、ProcessBuilder@クラスを使用してプログラムでコマンドを実行します。 wkhtmltopdf実行ファイルがシステムのPATH環境変数に追加されていること、および目的の出力PDFファイルを生成するために必要なスイッチとオプションが指定されていることを確認することが重要です。wkhtmltopdfからIronPDFへの移行を検討しているチーム向けに、 wkhtmltopdfからIronPDFへの移行手順を詳細に解説したステップバイステップガイドが用意されています。

To installIronPDFfor C#

1. パッケージマネージャーコンソールを使用するかビジュアルスタジオ UI 経由でIronPDFNuGet パッケージをインストールします。

2. コードに、IronPDF のネームスペースをインポートする次の using 文を追加します:

   using IronPdf;

   using IronPdf;

   Imports IronPdf

   $vbLabelText   $csharpLabel

3. HTML文字列からPDFを生成するには、次のコードを使用します。

   var Renderer = new ChromePdfRenderer();
   Renderer.RenderHtmlAsPdf("IronFile.html").SaveAs("IronPDF-file.pdf");

   var Renderer = new ChromePdfRenderer();
   Renderer.RenderHtmlAsPdf("IronFile.html").SaveAs("IronPDF-file.pdf");

   Dim Renderer = New ChromePdfRenderer()
   Renderer.RenderHtmlAsPdf("IronFile.html").SaveAs("IronPDF-file.pdf")

   $vbLabelText   $csharpLabel

4. ゼロから PDF を作成するには、次のコードを使用します:

   using IronPdf;
   
   var Renderer = new ChromePdfRenderer();
   // Create a PDF from a URL or local file path
   using var pdf = Renderer.RenderUrlAsPdf("https://www.amazon.com/?tag=hp2-brobookmark-us-20");
   // Export to a file or a Stream 
   pdf.SaveAs("url.pdf");

   using IronPdf;
   
   var Renderer = new ChromePdfRenderer();
   // Create a PDF from a URL or local file path
   using var pdf = Renderer.RenderUrlAsPdf("https://www.amazon.com/?tag=hp2-brobookmark-us-20");
   // Export to a file or a Stream 
   pdf.SaveAs("url.pdf");

   Imports IronPdf
   
   Private Renderer = New ChromePdfRenderer()
   ' Create a PDF from a URL or local file path
   Private pdf = Renderer.RenderUrlAsPdf("https://www.amazon.com/?tag=hp2-brobookmark-us-20")
   ' Export to a file or a Stream 
   pdf.SaveAs("url.pdf")

   $vbLabelText   $csharpLabel

Java 用のIronPDFのインストール

1.IronPDFのウェブサイトから IronPDF Java 向け ライブラリ をダウンロードします。

2. プロジェクトのクラスパスにIronPDFJAR ファイルを追加します。

3. コードに、IronPDF パッケージをインポートします:

   import com.ironsoftware.ironpdf.*;

   import com.ironsoftware.ironpdf.*;

   JAVA

4. インストールが完了したら、次のコードを使用して HTML コンテンツから PDF を生成します:

   import com.ironsoftware.ironpdf.*;
   import java.io.IOException;
   import java.nio.file.Paths;
   
   public class PdfExample {
      public static void main(String[] args) throws IOException {
          // Apply your license key 
          License.setLicenseKey("YOUR-LICENSE-KEY");
   
          // Set a log path 
          Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));
   
          // Render the HTML as a PDF, stored in myPdf as type PdfDocument
          PdfDocument myPdf = PdfDocument.renderHtmlAsPdf(" ~Hello World~  Made with IronPDF!");
   
          // Save the PdfDocument to a file
          myPdf.saveAs(Paths.get("html_saved.pdf"));
      }
   }

   import com.ironsoftware.ironpdf.*;
   import java.io.IOException;
   import java.nio.file.Paths;
   
   public class PdfExample {
      public static void main(String[] args) throws IOException {
          // Apply your license key 
          License.setLicenseKey("YOUR-LICENSE-KEY");
   
          // Set a log path 
          Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));
   
          // Render the HTML as a PDF, stored in myPdf as type PdfDocument
          PdfDocument myPdf = PdfDocument.renderHtmlAsPdf(" ~Hello World~  Made with IronPDF!");
   
          // Save the PdfDocument to a file
          myPdf.saveAs(Paths.get("html_saved.pdf"));
      }
   }

   JAVA

IronPDF は独自の HTML-PDF 変換エンジンを使用し、wkhtmltopdf のような外部ツールに依存していないことに注意が必要です。 開発者は、余白、ヘッダー、DPI、その他のレンダリングオプションを使用して、出力品質を微調整することもできます。

以下の表は、2つのライブラリの主な違いを一目でわかるようにまとめたものです。

Windows上でwkhtmltopdfの代替としてIronPDFを評価するチームには、30日間無料トライアルをご利用いただけます。

IronPDFで PDF ファイルを操作する

IronPDF は、PDF ドキュメントを作成、操作、レンダリングすることができる C# ライブラリです。 開発者がPDFファイルに対して、テキスト、画像、表の追加、 PDFファイルの結合、分割、変換など、さまざまな操作を実行できる使いやすいAPIを提供します。 ここでは、IronPDF を使用して PDF ファイルにテキストを追加する方法の例を示します:

using IronPdf;

var Renderer = new ChromePdfRenderer();
// Render a local HTML file as PDF
using var PDF = Renderer.RenderHtmlFileAsPdf("Project/MyHtmlDocument.html");
// Save the PDF to disk
PDF.SaveAs("Project/MyOutput.pdf");

using IronPdf;

var Renderer = new ChromePdfRenderer();
// Render a local HTML file as PDF
using var PDF = Renderer.RenderHtmlFileAsPdf("Project/MyHtmlDocument.html");
// Save the PDF to disk
PDF.SaveAs("Project/MyOutput.pdf");

Imports IronPdf

Private Renderer = New ChromePdfRenderer()
' Render a local HTML file as PDF
Private PDF = Renderer.RenderHtmlFileAsPdf("Project/MyHtmlDocument.html")
' Save the PDF to disk
PDF.SaveAs("Project/MyOutput.pdf")

wkhtmltopdf で PDF ファイルを操作する

wkhtmltopdfは、HTMLページをPDFファイルに変換するコマンドラインツールです。 HTMLをPDF形式にレンダリングするために、Qt WebKitレンダリングエンジンを使用しています。 Qt WebKitは現在積極的にメンテナンスされていないため、最新のHTML5、CSS3、 JavaScript機能のサポートはChromiumベースのエンジンに比べて遅れていることに注意してください。

using System.Text;
using System.Diagnostics;

class PdfGenerator
{
    static void Main(string[] args)
    {
        // Function to convert HTML to PDF using wkhtmltopdf
        ConvertHtmlToPdf("URL", "Sample.pdf");
        Console.WriteLine("PDF successfully created!");
        Console.ReadKey();
    }

    // Function to configure and start the wkhtmltopdf process
    public static void ConvertHtmlToPdf(string url, string filename)
    {
        // Construct the command line parameters
        StringBuilder paramsBuilder = new StringBuilder();
        paramsBuilder.AppendFormat("\"{0}\" \"{1}\"", url, filename);

        // Create and configure the process
        using (Process process = new Process())
        {
            // Specify the path to wkhtmltopdf executable
            process.StartInfo.FileName = "C:\\Program Files (x86)\\wkhtmltopdf\\bin\\wkhtmltopdf.exe";
            process.StartInfo.Arguments = paramsBuilder.ToString();

            // Configure process settings
            process.StartInfo.UseShellExecute = false;
            process.StartInfo.RedirectStandardOutput = true;
            process.StartInfo.RedirectStandardError = true;

            // Start the process and wait for it to exit
            process.Start();
            if (!process.WaitForExit(60000))
            {
                process.Kill();
                Console.WriteLine("Process terminated as it exceeded the time limit.");
            }
        }
    }
}

using System.Text;
using System.Diagnostics;

class PdfGenerator
{
    static void Main(string[] args)
    {
        // Function to convert HTML to PDF using wkhtmltopdf
        ConvertHtmlToPdf("URL", "Sample.pdf");
        Console.WriteLine("PDF successfully created!");
        Console.ReadKey();
    }

    // Function to configure and start the wkhtmltopdf process
    public static void ConvertHtmlToPdf(string url, string filename)
    {
        // Construct the command line parameters
        StringBuilder paramsBuilder = new StringBuilder();
        paramsBuilder.AppendFormat("\"{0}\" \"{1}\"", url, filename);

        // Create and configure the process
        using (Process process = new Process())
        {
            // Specify the path to wkhtmltopdf executable
            process.StartInfo.FileName = "C:\\Program Files (x86)\\wkhtmltopdf\\bin\\wkhtmltopdf.exe";
            process.StartInfo.Arguments = paramsBuilder.ToString();

            // Configure process settings
            process.StartInfo.UseShellExecute = false;
            process.StartInfo.RedirectStandardOutput = true;
            process.StartInfo.RedirectStandardError = true;

            // Start the process and wait for it to exit
            process.Start();
            if (!process.WaitForExit(60000))
            {
                process.Kill();
                Console.WriteLine("Process terminated as it exceeded the time limit.");
            }
        }
    }
}

Imports System.Text
Imports System.Diagnostics

Friend Class PdfGenerator
	Shared Sub Main(ByVal args() As String)
		' Function to convert HTML to PDF using wkhtmltopdf
		ConvertHtmlToPdf("URL", "Sample.pdf")
		Console.WriteLine("PDF successfully created!")
		Console.ReadKey()
	End Sub

	' Function to configure and start the wkhtmltopdf process
	Public Shared Sub ConvertHtmlToPdf(ByVal url As String, ByVal filename As String)
		' Construct the command line parameters
		Dim paramsBuilder As New StringBuilder()
		paramsBuilder.AppendFormat("""{0}"" ""{1}""", url, filename)

		' Create and configure the process
		Using process As New Process()
			' Specify the path to wkhtmltopdf executable
			process.StartInfo.FileName = "C:\Program Files (x86)\wkhtmltopdf\bin\wkhtmltopdf.exe"
			process.StartInfo.Arguments = paramsBuilder.ToString()

			' Configure process settings
			process.StartInfo.UseShellExecute = False
			process.StartInfo.RedirectStandardOutput = True
			process.StartInfo.RedirectStandardError = True

			' Start the process and wait for it to exit
			process.Start()
			If Not process.WaitForExit(60000) Then
				process.Kill()
				Console.WriteLine("Process terminated as it exceeded the time limit.")
			End If
		End Using
	End Sub
End Class

要約すると、IronPDF と wkhtmltopdf はどちらも C# で PDF ファイルを操作するための強力なツールです。IronPDFは、PDF ファイルを作成、操作、およびレンダリングするための使いやすい API を提供しており、wkhtmltopdf は HTML ページを PDF ファイルに変換できるコマンドラインツールです。 どちらのツールにもそれぞれの強みと弱みがあり、開発者は自分のニーズに最も適したものを選ぶべきです。

wkhtmltopdfとIronPDFの比較は？

IronPDF: フルBootstrapサポート

IronPDF の Chromium レンダリングエンジンは、最新の CSS フレームワークを完全にサポートします:

• Bootstrap 5:レスポンシブレイアウトのための完全なフレックスボックスとCSSグリッドのサポート -複雑なレイアウト: BootstrapホームページとBootstrapテンプレートをピクセルパーフェクトにレンダリングします -最新機能: CSS3 アニメーション、変換、トランジション、メディアクエリ
• CSSフレームワーク: Bootstrap、Tailwind CSS、Foundation、Bulmaはすべてシームレスに動作します

コード例: Bootstrapコンテンツのレンダリング

using IronPdf;

// Render a Bootstrap 5 layout
var renderer = new ChromePdfRenderer();

// Example: Bootstrap navigation and card layout
string bootstrapHtml = @"
<!DOCTYPE html>
<html>
<head>
    <link href='https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css' rel='stylesheet'>
</head>
<body>
    <nav class='navbar navbar-expand-lg navbar-dark bg-primary'>
        <div class='container'>
            <a class='navbar-brand' href='#'>My Company</a>
        </div>
    </nav>

    <div class='container mt-4'>
        <div class='row'>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 1</h5>
                        <p class='card-text'>Modern flexbox-based layout.</p>
                    </div>
                </div>
            </div>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 2</h5>
                        <p class='card-text'>Responsive grid system.</p>
                    </div>
                </div>
            </div>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 3</h5>
                        <p class='card-text'>CSS3 animations supported.</p>
                    </div>
                </div>
            </div>
        </div>
    </div>
</body>
</html>";

var pdf = renderer.RenderHtmlAsPdf(bootstrapHtml);
pdf.SaveAs("bootstrap-layout.pdf");

using IronPdf;

// Render a Bootstrap 5 layout
var renderer = new ChromePdfRenderer();

// Example: Bootstrap navigation and card layout
string bootstrapHtml = @"
<!DOCTYPE html>
<html>
<head>
    <link href='https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css' rel='stylesheet'>
</head>
<body>
    <nav class='navbar navbar-expand-lg navbar-dark bg-primary'>
        <div class='container'>
            <a class='navbar-brand' href='#'>My Company</a>
        </div>
    </nav>

    <div class='container mt-4'>
        <div class='row'>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 1</h5>
                        <p class='card-text'>Modern flexbox-based layout.</p>
                    </div>
                </div>
            </div>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 2</h5>
                        <p class='card-text'>Responsive grid system.</p>
                    </div>
                </div>
            </div>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 3</h5>
                        <p class='card-text'>CSS3 animations supported.</p>
                    </div>
                </div>
            </div>
        </div>
    </div>
</body>
</html>";

var pdf = renderer.RenderHtmlAsPdf(bootstrapHtml);
pdf.SaveAs("bootstrap-layout.pdf");

Imports IronPdf

' Render a Bootstrap 5 layout
Dim renderer As New ChromePdfRenderer()

' Example: Bootstrap navigation and card layout
Dim bootstrapHtml As String = "
<!DOCTYPE html>
<html>
<head>
    <link href='https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css' rel='stylesheet'>
</head>
<body>
    <nav class='navbar navbar-expand-lg navbar-dark bg-primary'>
        <div class='container'>
            <a class='navbar-brand' href='#'>My Company</a>
        </div>
    </nav>

    <div class='container mt-4'>
        <div class='row'>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 1</h5>
                        <p class='card-text'>Modern flexbox-based layout.</p>
                    </div>
                </div>
            </div>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 2</h5>
                        <p class='card-text'>Responsive grid system.</p>
                    </div>
                </div>
            </div>
            <div class='col-md-4'>
                <div class='card'>
                    <div class='card-body'>
                        <h5 class='card-title'>Feature 3</h5>
                        <p class='card-text'>CSS3 animations supported.</p>
                    </div>
                </div>
            </div>
        </div>
    </div>
</body>
</html>"

Dim pdf = renderer.RenderHtmlAsPdf(bootstrapHtml)
pdf.SaveAs("bootstrap-layout.pdf")

上記のコードは、すべての Bootstrap スタイリング、フレックスボックスレイアウト、およびレスポンシブグリッドシステムを保持してIronPDFで完璧にレンダリングされます。

wkhtmltopdf: CSSフレームワークのサポート範囲が狭まる

wkhtmltopdfのQt WebKitエンジンは、現代のフレームワークが依存するCSS仕様に対応するように設計されていませんでした。

• Flexboxのギャップ： Bootstrap 4以降はFlexboxに大きく依存していますが、Qt WebKitのエンジンはFlexboxを完全にはサポートしていません。
• CSS Grid はサポートされていません:最新のグリッドレイアウトは Qt WebKit のレンダリング機能の範囲外です
• Engine age: Qt WebKit は 2016 年に最終更新されたため、@--CODE-1399--@、@--CODE-1400--@、コンテナクエリなどの最新の CSS3 機能はサポート範囲外です。 -必要な回避策:開発者は古いバージョンの Bootstrap (Bootstrap 3 以前) を使用するか、テーブルベースのフォールバックを実装する必要があります。

CSS フレームワークサポートの詳細およびフレックスボックス/Bootstrap のレンダリング問題を解決するための記事については、Bootstrap & Flexbox CSS ガイド をご覧ください。