IronPDFクイックスタートガイド
IronPDFをインストールし、最初のPDFをわずか5分で作成しましょう。シンプルなAPIでHTML、DOCX、画像などをピクセルパーフェクトなPDFに変換できます。
1. 必要条件
- .NET Framework 4.6.2+ または .NET Core 3.1+ または .NET 5+
- Visual C++ 再頒布可能パッケージ (Windows用)。
2. IronPDFをインストール
標準的なIronPDFインストールはローカルで実行されます。 Docker/マイクロサービスでデプロイする場合は、リモートエンジンモードガイドをご確認ください。
IronPDF NuGet library:にアクセスしてください。
- ソリューションエクスプローラーで右クリックし、参照を選択します。
- 'Manage NuGet Packages' > 'Browse' を選択し、IronPDFを検索
Install-Package IronPdf
- IronPDFのDLLパッケージをダウンロードしてください。
- お使いのOS用のZIPファイルをソリューションディレクトリ内の場所に解凍してください。
- Visual Studioのソリューションエクスプローラーで、"依存関係"を右クリックします。
- 'Add Project Reference' > 'Browse'を選択して、zipから抽出したすべてのDLLを含めます。
プラットフォーム固有ガイド
3. ライセンスキーを適用
IronPDF ライセンス を購入するか、30 日間のトライアルを開始することを選択すると、ライセンスキーがあなたのメールに送信されます。 キーをコピーして、アプリの開始時に追加してください。
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
4. 最初のPDFを作成
.csファイルの冒頭にこれを追加してください。
using IronPdf;
using IronPdf;
Imports IronPdf
PDFオブジェクトを作成する最も簡単な方法は、幅と高さだけを使用します。 この PdfDocument コンストラクタは、カスタマイズ可能な空白の PDF を作成します。
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
ChromePdfRenderer.RenderHtmlAsPdf メソッドを使用すると、組み込みの Chromium エンジンを利用して、あらゆる HTML(HTML5 を含む)を PDF に変換できます。
using IronPdf;
IronPdf.ChromePdfRender
.StaticRenderHtmlAsPdf("<p>Hello Word</p>")
.SaveAs("string-to-pdf.pdf");
using IronPdf;
IronPdf.ChromePdfRender
.StaticRenderHtmlAsPdf("<p>Hello Word</p>")
.SaveAs("string-to-pdf.pdf");
Imports IronPdf
IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")
DocxToPdfRenderer クラスを使用して WORD 文書を PDF に変換することで、DOCX ファイルをカスタマイズ可能な PDF に直接レンダリングし、.NET アプリにシームレスに統合することができます。
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf
Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")
5. より高度な例
IronPDFは、単純なPDFの作成と変換に加えて、より強力なPDFのカスタマイズオプションも提供します。
TextHeaderFooter をインスタンス化し、テキストを追加して PDF に埋め込むことで、ヘッダーやフッターを作成できます。
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
CenterText = "This is the header!",
};
// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
CenterText = "This is the footer!",
};
// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);
pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
CenterText = "This is the header!",
};
// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
CenterText = "This is the footer!",
};
// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);
pdf.SaveAs("addTextHeaderFooter.pdf");
Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")
RedactTextOnAllPages を使用すると、文書全体から特定のフレーズを簡単に削除できます。
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")
' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")
pdf.SaveAs("redacted.pdf")
C#で2つのPDFファイルをMergeメソッドを使用して結合します。 新規またはインポートされた PdfDocument に対しては、ReplaceTextOnAllPages を使用し、古いテキストを新しいテキストに置き換えてください。
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");
string oldText = ".NET6";
string newText = ".NET7";
// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);
pdf.SaveAs("replaceText.pdf");
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");
string oldText = ".NET6";
string newText = ".NET7";
// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);
pdf.SaveAs("replaceText.pdf");
Imports IronPdf
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")
Private oldText As String = ".NET6"
Private newText As String = ".NET7"
' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)
pdf.SaveAs("replaceText.pdf")
クイックトラブルシューティング
| 課題 | ソリューション |
|---|---|
| Visual C++ ランタイムの欠落 | Visual C++ Redistributableのインストール - Chromeエンジンにはx86とx64の両方のバージョンが必要です。 |
| ライセンスが認識されない | IronPdf.License.IsLicensedプロパティで確認してください。IronPDFを操作する前にライセンスが適用されていることを確認してください。 |
| 遅いファーストレンダリング | 起動時にIronPdf.Installation.Initialize()を呼び出し、レンダリングエンジンを初期化します。 |
| Linux/Dockerの依存関係 | 依存関係の自動インストールのために Installation.LinuxAndDockerDependenciesAutoConfig = true を設定します。 |
次のステップ
よくある質問
リモートPDF生成のためにIronPDFEngineをどのようにセットアップできますか?
リモートPDF生成のためにIronPDFEngineをセットアップするには、NuGetからIronPdf.Slimパッケージをインストールし、IronPDFConnectionConfigurationクラスを使用して接続設定を構成します。このセットアップにより、アプリケーションをIronPDFEngineインスタンスにリモートで接続できます。
アプリケーションでIronPDFEngineを使用する主な利点は何ですか?
アプリケーションでIronPDFEngineを使用すると、PDFタスクをリモートで実行することができ、特に古いシステムやモバイルプラットフォームでのプラットフォーム固有の互換性の問題を回避できます。また、実行中に.NETランタイムを必要としません。
ネイティブのPDFライブラリの代わりにIronPDFEngineを利用する理由は何ですか?
パフォーマンス集約型のPDF機能をリモートで実行し、異なるオペレーティングシステムとの互換性の問題を軽減し、HTMLからPDFへの変換にChromeと同一のレンダラを利用することで性能を向上させるためにIronPDFEngineを選ぶかもしれません。
IronPDFEngineで水平方向のスケーリングはサポートされていますか?
いいえ、現在IronPDFEngineは水平方向のスケーリングをサポートしておらず、サーバーメモリ内でのPDFファイルバイナリの取り扱い方法のため、複数のインスタンス間で負荷分散することはできません。
IronPDFEngineは異なるオペレーティングシステムで動作できますか?
IronPDFEngineはDockerコンテナを使用してLinuxシステムで動作するように設計されています。ただし、バイナリはプラットフォーム固有であるため、使用するオペレーティングシステムに適したバージョンを使用する必要があります。
IronPDFEngineを使用しているときにPDFの出力が異なる場合、どうすればよいですか?
異なるオペレーティングシステムの動作によりPDFの出力がわずかに異なることがあります。差異を最小限に抑えるために、正しいDockerイメージを使用し、レンダリングに影響を与える可能性のあるOS特定の設定を確認してください。
アプリケーションがIronPDFEngineの正しいバージョンを使用していることをどうやって確認できますか?
互換性を確保するため、各バージョンのIronPDFには対応するバージョンのIronPDFEngineが必要です。クロスバージョンの問題を避けるために、両方のコンポーネントを同時に更新してください。
WindowsでIronPDFEngineを使用する際の制限は何ですか?
WindowsでIronPDFEngineを使用する場合、DockerのLinuxコンテナが必要であり、サーバーポートが到達可能であることを確認する必要があります。バイナリはプラットフォーム固有であり、Linuxコンテナへの切り替えが必要です。
リモートIronPDFEngineサーバーに接続するようにIronPDFを構成するにはどうすればよいですか?
リモートサーバー用にIronPDFを構成するには、Installation.ConnectToIronPDFHostをIronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServerメソッドと共に使用し、サーバーのIPとポートの詳細を指定します。
IronPDFEngineを使用する際にアプリケーションのサイズを最小化するためにはどのパッケージを使用すればよいですか?
アプリケーションサイズを削減するためにIronPDFをIronPDFEngineで実行するのに必要なコンポーネントのみを含むIronPdf.SlimパッケージをNuGetから使用するべきです。

