IRONPDFの使用

C# プログラムでPDFファイルを作成

開発者にとって、プログラム的にPDFファイルを作成する必要がある場面は多く存在します。 ソフトウェアでプログラム的にPDFレポートやその他のPDFファイルを生成する必要があるかもしれません。 ゼロからコードや関数を作成するのは、時間がかかり、費用がかかり、非効率です。 ここにIronPDFが登場します。 .NETでプログラムによってPDFファイルを作成するのはイライラすることもありますが、幸いなことに、それをずっと扱いやすくするソリューションが今では存在します。

チュートリアルのトピック

このチュートリアルでは次のトピックを取り上げます:

プログラムでPDFファイルを作成する手順

  • ステップ1: C#プロジェクトを作成
  • ステップ2: IronPdfライブラリをインストール

    • 方法 1: NuGet パッケージ マネージャー

    • 方法2: NuGet パッケージマネージャーコンソール
  • 方法 3: DLLファイルの使用
  • ステップ 3: IronPdf ネームスペースを追加する
  • ステップ4: プログラムによってPDFドキュメントを作成する

    • 4.1: HTML文字列を使用してプログラムでPDFドキュメントを作成する

    • 4.2: HTMLファイルを使用してプログラムからPDFドキュメントを作成する

    • 4.3: URLを使用してプログラムによってPDFドキュメントを作成する
  • プログラムでフォーマット付きのPDFドキュメントを作成する方法
  • サマリー

IronPDF

IronPDFは、.NET開発者向けのC# PDFライブラリであり、プログラムでPDFファイルを作成するために使用できるクラスのセットを提供します。 これらのクラスはIronPdfアセンブリにあり、C#、VB.NET、F#などの.NET言語で簡単に使用できるように設計されています。ライブラリは、PDFドキュメントの作成、既存のPDFの操作、PDFの読み取りのための多くの機能を提供します。

IronPDFライブラリの現在のバージョンは、以下の機能をサポートしています:

プログラムでPDFファイルを作成する手順

この記事では、このデモのためにコンソールアプリケーションテンプレートを使用します。 要件と選択に応じてお好きな方を使用できます。PDFファイル生成ツールを追加したい既存のプロジェクトを使用することもできます。

ステップ1:C#プロジェクトを作成

このチュートリアルでは、Visual StudioとC#プログラミング言語を使用してプロジェクトを構築します。 HTMLとC#言語に関する基本的な知識が必要です。 また、Visual Studioに慣れておくことをお勧めします。

IronPDF C#ライブラリを使用してプログラム的にPDFファイルを作成する複数の方法を見ていきます。 まず、C#プロジェクトを作成しましょう。

  • Visual Studioを開きます。
  • 新しいC#プロジェクトを作成するか、既存のプロジェクトを開く。
  • プロジェクトに名前を付けてください。
  • .NET Core >= 3.1を選択してください。3.1はサポートされており、すべてのデバイスで動作します。最新バージョンの.NET Coreをお勧めします。

    では、ステップ2に進みましょう。

ステップ 2: IronPDFライブラリをインストールする

先に進む前に、プロジェクトにIronPdfライブラリをインストールする必要があります。 これをさまざまな方法で行うことができます。

方法 1: NuGet パッケージ マネージャー

NuGet パッケージ マネージャーから IronPdf C# ライブラリをインストールできます。 ツール > NuGet パッケージ マネージャー > NuGet パッケージ ソリューションの管理をクリックして、NuGet パッケージ マネージャーを開きます。 これにより、NuGetパッケージマネージャー ソリューションエクスプローラーが開きます。

C#でプログラム的にPDFファイルを作成する、図1: NuGetパッケージマネージャーを開く

NuGet パッケージ マネージャーを開く

「ブラウズ」をクリックし、検索バーに「IronPDF」と入力してください。 次の結果が表示されます。 IronPdf を選択して、インストールボタンをクリックします。 ライブラリのインストールが開始されます。

C# プログラムでPDFファイルを作成、図2: IronPdfパッケージの検索とインストール

IronPdfパッケージを検索してインストール

方法2: NuGet パッケージマネージャーコンソール

NuGetパッケージマネージャーコンソールを使用して、簡単にライブラリをインストールできます。 インストールする際に管理者権限は必要ありません。 プロジェクトにIronPdfライブラリをインストールするには、NuGetコマンドを使用します。

Install-Package IronPdf

C# プログラムによる PDF ファイルの作成, 図3: コマンドラインで IronPdf パッケージをインストール

コマンドラインでIronPdfパッケージをインストールする

方法3: DLLファイルの使用

プロジェクトでIronPDFを使用する3番目の方法は、IronPDFライブラリからDLLファイルを追加することです。 DLLファイルをダウンロードできます。

  • DLLのzipファイルをダウンロードしてください。特定のフォルダーに解凍してください。
  • Visual Studioでプロジェクトを開きます。 ソリューションエクスプローラーで、リファレンスを右クリックし、IronPDFのDLLファイルを参照します。

    IronPDFをインストールするための詳細なインストールガイドをご覧ください。

ステップ 3: IronPdf ネームスペースを追加する

次に、IronPdf 名前空間をプログラムに追加します。 コードの上部に指定された行を追加する必要があります。

using IronPdf

これはIronPDFの機能にアクセスすることを可能にします。 IronPDFの機能を使用したいファイルには、必ずこのコード行を追加する必要があります。

手順4:プログラムでPDFドキュメントを作成する

以下の複数の方法でPDFを作成する方法を、IronPDFが提供します。 簡単な関数を使用してPDFファイルを作成することがどれほど簡単かを見てみましょう。 HTML文字列を使用してPDFを作成することから始めましょう。

4.1. HTML文字列を使用してプログラムでPDFを作成

IronPDFライブラリでは、HTMLがスタイリングのために使用されます。 PDFドキュメントを生成するためにIronPDFライブラリを使用するには、HTML言語の基本知識が必要です。

IronPDFライブラリを使用すると、HTML文字列を簡単に処理してPDF形式に変換することができます。 コードを使用してそれを行う方法を見てみましょう。

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>"

Dim renderer = New ChromePdfRenderer()
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")
$vbLabelText   $csharpLabel

このコードは、htmlString変数に格納されたコンテンツを含むPDFファイルを生成します。 このコードサンプルでは、RenderHtmlAsPdf 関数が使用されています。 この関数はHTML文字列をPDFドキュメントに変換します。

PDFファイルを生成するためにIronPDFライブラリを使用するには、HTMLタグに精通している必要があります。 出力PDFファイルを保存するために、SaveAs関数を使用します。以下に出力PDFファイルを確認できます。

出力:

C# プログラムを使ってPDFファイルを作成、図4: PDFファイルの出力

PDFファイル出力

HTMLファイルを使用してプログラムでPDFを作成する

IronPDFライブラリは、HTMLファイルからPDFファイルを作成する素晴らしい機能を提供します。IronPDFは、画像、CSS、フォームなど、HTMLファイル内のすべてを直接PDFドキュメントに変換します。 他のライブラリや関数を追加で処理する必要はありません。 IronPDFは、任意のHTMLファイルを直接PDFファイルに変換します。

以下は、HTMLファイルからPDFファイルを作成するためのサンプルコードです:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")
$vbLabelText   $csharpLabel

私たちはRenderHtmlFileAsPdf関数を使用して、HTMLファイルからPDFを作成します。 この関数は、指定されたコードサンプルで使用される最も重要な関数です。 HTMLファイルの場所を関数のパラメーターとして指定するか、HTMLファイルをソースコードのbinフォルダーに置くことができます。その場合はRenderHtmlFileAsPdf関数のパラメーターに拡張子付きのファイル名だけを指定する必要があります。 このコードを実行すると、出力されたPDFファイルはbinフォルダーに保存されます。 SaveAs関数は、作成したPDFファイルを保存するのに役立ちます。

4.3. URLを使用してプログラムでPDFを作成する

プログラムでURLのPDFファイルをプログラム的に作成する必要がある場合があります。 これを一からコーディングする場合、非常に技術的な作業となる可能性があります。 IronPDFは、URLからPDFを作成するための優れた機能を提供することで役立ちます。 任意のURLを使用してPDFを作成できます。

やり方を見てみましょう。

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")
$vbLabelText   $csharpLabel

上記のコードは、RenderUrlAsPdf 関数のために与えられたURLパラメータのPDFを作成します。 この関数はURLのPDFを作成します。 これを一から行おうとすると非常に複雑な作業になりますが、IronPDFは開発者に対して、任意のURLをPDFに変換する簡単なプロセスを提供します。 SaveAs関数は、出力ファイルをbinフォルダに保存するために使用されます。 ファイル形式をPDFに設定するには、SaveAs関数のファイル名パラメータに.pdf拡張子を指定する必要があります。 プロジェクトフォルダー内に bin フォルダーが表示されます。 出力は以下に表示されます。

出力:

C# プログラムによる PDF ファイルの作成、図 5: URL から PDF ファイルを作成

URLからPDFファイルを作成する

4.4. ASP.NET Web Formsを使用してプログラム的にPDFを作成

ASP.NETは、HTMLの機能を拡張し、ブラウザでのウェブ開発をサポートするサーバーサイドのプログラミングフレームワークです。 ASP.NET ページは HTML、CSS、および JavaScript で記述されており、ASPX ファイル (.aspx) としてコーディングできます。 ASP.NETウェブフォームは、ユーザーフレンドリーで機能が豊富なウェブサイト、オンラインバンキング、イントラネット、および会計システムを作成します。

IronPDFライブラリを使用してASP.NETウェブフォームをPDFに変換します。 最初はウェブページとしてレンダリングされたものを、ウェブブラウザで表示およびダウンロードするためにPDFに変換します。 IronPDFのAspxToPdfクラスを使用して変換を完了します。

どのようにそれを行うか見てみましょう:

  1. Visual StudioでASP.NET Webフォームプロジェクトを作成します。 最新バージョンのVisual Studio をお勧めします。

  2. NuGet パッケージ マネージャーで DLL ファイルを使用して IronPDF ライブラリーをインストールしてください。選択に応じてインストールできます。また、NuGet パッケージ マネージャー コンソールを使用してインストールすることもできます。

  3. 次に、PDFファイルに変換したい任意のApexウェブページのコードを開きます。ここでは、プロジェクトのデフォルトのaspxページのPDFを作成します。

    C# プログラミングでPDFファイルを作成, 図 6: Visual StudioのWebフォームプロジェクト構造

    Visual StudioにおけるWebフォームプロジェクト構造

  4. Default.aspx.csファイルを開きます。ファイルにIronPdf名前空間を追加します。これが最も重要な行です。

    using IronPdf;

  5. 下記のコードを Page_Load 関数に記述して、ページの PDF ドキュメントを作成してください。

    AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

    以上です! AspxウェブページのPDFファイルが作成されました。 プロジェクトを実行すると、ブラウザにウェブページのPDFが表示されます。 結果は、Ctrl+Pを押してPDFを作成したときと同じです。ここでは、aspxファイルのPDFを作成するためにCtrl+Pを押す必要はありませんでした。

    これはサーバーサイドで行われました。このコードでは、IronPDFのAspxToPdfクラスを使用しています。 RenderThisPageAsPdf関数は、AspxウェブページのPDFを作成します。

    上記のコードはブラウザ内でPDFファイルを表示します。 以下のコードを Page_Load 関数に追加することで、システムに PDF ファイルを直接ダウンロードできます:

    AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

    このコードは、システム内のaspxウェブページのPDFファイルをダウンロードします。 Aspx PDFファイルの名前も設定できます。ヘッダー、フッター、印刷オプション、品質など、修正やフォーマットには複数のオプションがあります。詳細については、この包括的なAspxからPDFへのチュートリアルをご覧ください。

    出力:

    C# プログラムによるPDFファイルの作成、図7: サーバーサイドでPDFファイルをレンダリングした出力

    サーバーサイドからPDFファイルをレンダリングした際の出力

    最新のMicrosoftテクノロジーを探求してBlazorアプリケーションでPDFファイルを作成

プログラムによって書式設定されたPDFを作成する

PDFを作成する際、ほとんどの問題はPDFドキュメントのフォーマット中に発生します。 PDFをプログラムでフォーマットすることは簡単ではありません。 しかし、現在はIronPDFという形で解決策があります。 IronPDFは、作成中のPDFファイルをカスタマイズするためのさまざまなフォーマットオプションを提供します。 それは、ヘッダー、フッター、余白、および他の多くのフォーマットオプションを追加する方法を提供します。

IronPDFを使用すると、ページの向き、ページサイズ、およびタイトルを設定することができます。 フォントサイズ、フォントカラー、フォントタイプ、およびその他のフォント関連の操作にも対応しています。 区切り線とカスタムテキストでフッターとヘッダーを追加できます。 IronPDFを使用してPDFファイルをカスタマイズする方法を見てみましょう。

  • C# コンソール プロジェクトを作成します。 要件に応じて、GUIプロジェクトを作成することもできます。 既存のプロジェクトを開くこともできます。
  • NuGetパッケージマネージャーまたはDLLファイルを使用してIronPDFライブラリをインストールします。
  • コードファイルの先頭にIronPDF名前空間を追加します。

    アプリケーションのセットアップが完了しました。 次に、PDFファイルに以下のコードを追加します:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;

//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;

//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40)
Renderer.RenderingOptions.PrintHtmlBackgrounds = True
Renderer.RenderingOptions.Title = "PDF Generated"
Renderer.RenderingOptions.Zoom = 100

'Margin Setting
Renderer.RenderingOptions.MarginTop = 40
Renderer.RenderingOptions.MarginLeft = 20
Renderer.RenderingOptions.MarginRight = 20
Renderer.RenderingOptions.MarginBottom = 40

Renderer.RenderingOptions.FirstPageNumber = 1

'Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = True
Renderer.RenderingOptions.TextHeader.CenterText = "Header!"
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

'Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = True
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial
Renderer.RenderingOptions.TextFooter.FontSize = 10
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}"
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"

Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>"
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")
$vbLabelText   $csharpLabel

このコードはPDFファイルをフォーマットしています。 RenderingOptionsは、PDFドキュメントを作成する際に異なるプロパティを設定するための主要なツールです。

  • Renderer.RenderingOptions.TextHeader
  • このコード行は、PDFファイルのヘッダーを設定するために使用されます。 次のコード行で、ヘッダーのより多くのプロパティにアクセスできます。
  • Renderer.RenderingOptions.TextFooter
  • このコード行は、テキスト、フッターの右側と左側、フォントサイズ、その他多くのフッターのプロパティを設定します。
  • Renderer.RenderingOptions.PaperOrientation
  • このコード行は、ユーザーがPDFファイルのページの向きを設定できるようにします。それは横向きまたは縦向きとして指定することができます。
  • Renderer.RenderingOptions.Title

    • PDFファイルのタイトルを設定するには、この行を使用できます。

    最後の行では、RenderHtmlAsPdf関数を使用してHTML文字列のPDFを作成しますが、HTMLファイルを使用して現在の書式を保持しつつシームレスにPDFに変換することも可能です。 これは、PDFドキュメントに関するすべてをカスタマイズする完全な自由を提供するIronPDFの非常に便利な機能です。

    出力:

    C# プログラムでPDFファイルを作成する、図8: 書式設定をサポートしたPDF出力

    フォーマット対応のPDF出力

サマリー

このチュートリアルでは、IronPDF C# ライブラリを使用してプログラムでPDFを作成する方法を紹介します。 HTML文字列、HTMLファイル、URL、およびASP.NET WebフォームからPDFファイルを作成する方法を見てきました。 IronPDF ライブラリ機能を使えば、PDFファイルの操作や書式設定がとても簡単になります。 PDFファイルをプログラムで作成およびフォーマットするために、必要なのはほんの数行のコードだけです。 IronPDFは、ソフトウェア内でPDFファイルを操作する必要がある開発者や企業に最適です。

無料バージョンを試してみることができ、クレジットカードの支払いが不要な無料トライアルキーが利用可能です。 さらに、現在の特別オファーでは、IronPDFの5つの製品を2つ分の価格で手に入れることができます

チペゴ
ソフトウェアエンジニア
チペゴは優れた傾聴能力を持ち、それが顧客の問題を理解し、賢明な解決策を提供する助けとなっています。彼は情報技術の学士号を取得後、2023年にIron Softwareチームに加わりました。現在、彼はIronPDFとIronOCRの2つの製品に注力していますが、顧客をサポートする新しい方法を見つけるにつれて、他の製品に関する知識も日々成長しています。Iron Softwareでの協力的な生活を楽しんでおり、さまざまな経験を持つチームメンバーが集まり、効果的で革新的な解決策を提供することに貢献しています。チペゴがデスクを離れているときは、良い本を楽しんだり、サッカーをしていることが多いです。
< 以前
C# PDFジェネレーターの包括的ガイド: IronPDFを使用した簡単なPDF作成と操作
次へ >
C#でPDFファイルを開く方法