C#によるIronPDFのレンダリングオプションの使い方

IronPDFでレンダリングオプションを使うには？ 多くのレンダリングオプションプロパティはHTMLからPDFへの変換用に設計されていますが、他のPDF変換タイプでも機能します。 MarkdownをPDFにレンダリングし、レンダリング・オプションを使って出力を設定しましょう。 特にHTMLの変換については、HTMLファイルをPDFに変換する、またはHTML文字列をPDFに変換するについて学んでください。 ### なぜレンダリング オプションを設定する必要があるのですか? レンダリングオプションを設定することで、カスタム用紙サイズ、特定の余白、ヘッダーとフッター、動的コンテンツ用の有効なJavaScriptなど、正確な仕様でPDFが生成されるようにします。 このコントロールは、Professionalな文書やレポート用に新しいPDFを作成する際に非常に重要です。 ### 複数のレンダリング オプションを適用するとどうなりますか? 複数のレンダリングオプションを組み合わせて、最終的なPDF出力を作成します。 各オプションは特定のレンダリングアスペクトを変更し、IronPDFは変換中にそれらを順次適用します。 たとえば、マージンとヘッダーの両方を設定する場合、`UseMarginsOnHeaderAndFooter` プロパティを使ってオーバーライドしない限り、ヘッダー コンテンツはマージンの設定を尊重します。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ```### 高度なレンダリング オプションの例

この包括的な例では、複数のレンダリングオプションを組み合わせて、Professionalなドキュメントを生成する方法を示します。 このアプローチは、[ヘッダーとフッターを追加する](https://ironpdf.com/how-to/headers-and-footers/)必要がある場合や、[カスタム用紙サイズ](https://ironpdf.com/how-to/custom-paper-size/)で作業する場合に役立ちます： ```csharp using IronPdf; using IronPdf.Rendering; // Create renderer with advanced options var renderer = new ChromePdfRenderer(); // Configure paper and layout settings renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait; renderer.RenderingOptions.PaperSize = PdfPaperSize.A4; renderer.RenderingOptions.PrintHtmlBackgrounds = true; // Set margins for professional layout renderer.RenderingOptions.MarginTop = 40; // mm renderer.RenderingOptions.MarginBottom = 40; // mm renderer.RenderingOptions.MarginLeft = 20; // mm renderer.RenderingOptions.MarginRight = 20; // mm // Enable JavaScript for dynamic content renderer.RenderingOptions.EnableJavaScript = true; renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 seconds for JS to execute // Add professional header with page numbers renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter { Height = 25, HtmlFragment = @"

Document Title - Page {page} of {total-pages}

", DrawDividerLine = true }; // Add footer with timestamp renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter { Height = 20, HtmlFragment = @"

Generated on {date} at {time}

" }; // Render HTML content string htmlContent = @"

This document demonstrates advanced rendering options.

"; PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("professional-document.pdf"); ```

---

## 利用可能なレンダリング オプションには何がありますか? 高度なオプションは、余白、用紙の向き、用紙サイズなどのPDFレンダリング設定を定義します。 これらのオプションを理解することは、カスタムマージンを設定したり、異なるビューポート設定やズームレベルで作業する必要がある場合に役立ちます。 ### どのレンダリング オプションが最も一般的に使用されていますか? 最もよく使用されるレンダリングオプションには、マージン設定、用紙サイズ設定、ヘッダー/フッター設定、JavaScriptの有効化などがあります。 これらのオプションは、ほとんどのPDFカスタマイズのニーズに対応しています。 ウェブベースのコンテンツでは、JavaScriptのレンダリングオプションにより、動的要素が正しくレンダリングされるようにします。 ### 正しいレンダリング オプションを選択するにはどうすればよいですか? 印刷レイアウトには余白設定を使用し、動的なWebコンテンツにはJavaScriptを有効にし、プロフェッショナル文書にはヘッダー/フッターを設定し、特定の出力形式には用紙サイズを調整するなど、要件に応じてレンダリングオプションを選択します。 ウェブコンテンツを扱う際には、最適なレンダリングのためにCSSのメディアタイプを考慮してください。 ### 高度なレンダリング オプションはいつ使用すべきですか? カスタムCSSインジェクション、LaTeX数学レンダリング、グレースケール出力などの特殊な機能や、特定のJavaScript実行タイミングを必要とする複雑なWebアプリケーションを扱う場合は、高度なレンダリングオプションを使用してください。 WaitForクラスは、複雑なシナリオのレンダリング遅延を正確に制御します。 ### フォーム要素を扱う

HTMLにフォーム要素が含まれている場合、IronPDFはそれらを自動的にインタラクティブなPDFフォームに変換します： ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); // Enable PDF form creation from HTML forms renderer.RenderingOptions.CreatePdfFormsFromHtml = true; // HTML with form elements string formHtml = @"

Name:
Email:
Subscribe:
Submit

"; PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml); pdfWithForms.SaveAs("interactive-form.pdf"); ``` 以下は、利用可能なさまざまなオプションを示す表です。

クラス	ChromePdfRenderer
翻訳内容	用紙サイズ、DPI、ヘッダー、フッターなどのPDF印刷オプションを定義するために使用します。
プロパティ/機能	タイプ	翻訳内容
`CustomCookies`	`Dictionary<string, string>`	HTMLレンダリング用のカスタムクッキー。クッキーはレンダリング間で持続しないため、毎回設定する必要があります。
`PaperFit`	`VirtualPaperLayoutManager`	A manager for setting up virtual paper layouts, controlling how content will be laid out on PDF "paper" pages. Includes options for Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
`UseMarginsOnHeaderAndFooter`	`UseMargins`	ヘッダーとフッターをレンダリングするときは、メインドキュメントのマージン値を使用してください。
`CreatePdfFormsFromHtml`	`bool`	すべての HTML フォーム要素を編集可能な PDF フォームにします。デフォルト値はtrueです。
`CssMediaタイプ`	`PdfCssMediaタイプ`	Media="screen" CSSスタイルとスタイルシートを有効にします。デフォルト値は PdfCssMediaタイプ.Screen です。
`CustomCssUrl`	`string`	カスタムCSSスタイルシートをレンダリング前にHTMLに適用できるようにします。ローカルファイルパスまたはリモートURLを指定できます。HTMLをPDFにレンダリングするときにのみ適用されます。
`EnableJavaScript`	`bool`	ページがレンダリングされる前にJavaScriptとJSONを実行できるようにします。Ajax/Angularアプリケーションからの印刷に最適です。デフォルト値はfalseです。
`EnableMathematicalLaTex`	`bool`	Mathematical LaTeX Elementsのレンダリングを可能にします。
`Javascript`	`string`	すべてのHTMLが読み込まれた後、PDFレンダリングの前に実行されるカスタムJavaScript文字列。
`JavascriptMessageListener`	`StringDelegate`	ブラウザJavaScriptのコンソールメッセージが利用可能になるたびに呼び出されるメソッドコールバック。
`FirstPageNumber`	`int`	PDF のヘッダーとフッターで使われる最初のページ番号。デフォルト値は1です。
`TableOfContents`	`TableOfContentsタイプs`	HTMLドキュメント内でid "ironPdf-toc "の要素が見つかった場所に目次を生成します。
`GrayScale`	`bool`	白黒PDFを出力します。デフォルト値はfalseです。
`TextHeader`	`ITextHeaderFooter`	すべてのPDFページのフッターコンテンツをテキストとして設定し、"メールマージ"をサポートし、URLを自動的にハイパーリンクに変換します。
`TextFooter`
`HtmlHeader`	`HtmlHeaderFooter`	すべてのPDFページのヘッダーコンテンツをHTMLとして設定します。メールマージ"をサポートします。
`HtmlFooter`
`InputEncoding`	`Encoding`	文字列としての入力文字エンコーディング。デフォルト値はEncoding.UTF8です。
`MarginTop`	`double`	PDFの"用紙"上部の余白をミリメートルで指定します。枠なし印刷や商業印刷アプリケーションではゼロに設定します。デフォルト値は25です。
`MarginRight`	`double`	右PDFの"紙"の余白をミリメートル単位で指定します。枠なし印刷や商業印刷の用途ではゼロに設定します。デフォルト値は25です。
`MarginBottom`	`double`	PDFの"用紙"下部の余白をミリメートルで指定します。枠なし印刷や商業印刷のアプリケーションではゼロに設定します。デフォルト値は25です。
`MarginLeft`	`double`	PDF の左側の"紙"の余白をミリメートル単位で指定します。枠なし印刷や商業印刷の用途ではゼロに設定します。デフォルト値は25です。
`PaperOrientation`	`PdfPaperOrientation`	PDF の用紙の向き（Portrait や Landscape など）。デフォルト値はPortraitです。
`PaperSize`	`PdfPaperSize`	用紙サイズの設定
`SetCustomPaperSizeinCentimeters`	`double`	用紙サイズをセンチメートル単位で設定します。
`SetCustomPaperSizeInInches`		用紙サイズをインチで設定します。
`SetCustomPaperSizeinMilimeters`		用紙サイズをミリメートル単位で設定します。
`SetCustomPaperSizeinPixelsOrPoints`		用紙サイズを画面ピクセルまたはプリンタポイントで設定します。
`PrintHtmlBackgrounds`	`Boolean`	背景色と画像をHTMLから出力するかどうかを指定します。デフォルト値はtrueです。
`RequestContext`	`RequestContexts`	クッキーのような特定のリソースの分離を決定し、このレンダリングのコンテキストを要求します。
`Timeout`	`Integer`	レンダリングタイムアウトを秒単位で指定します。デフォルト値は60です。
`Title`	`String`	PDFドキュメントの名前とタイトルのメタデータは、IronPdf MVCとRazorエクステンションのメールマージと自動ファイルネーミングに便利です。
`ForcePaperSize`	`Boolean`	HTMLからPDFを生成した後にページのサイズを変更することで、IronPdf.ChromePdfRenderOptions.PaperSizeで指定されたとおりのページサイズを強制します。HTMLからPDFをレンダリングする際に、ページサイズの小さなエラーを修正します。
`WaitFor`	`WaitFor`	ユーザーがレンダリング前に特定のイベントを待つためのwait-forメカニズムの設定を保持するラッパー・オブジェクトです。デフォルトでは、何も待ちません。

より多くの機能を調べる準備はできていますか？ チュートリアルページをご覧ください：[PDFを変換する](https://ironpdf.com/tutorials/convert-pdf/)をご覧ください。