C#でカスタム用紙サイズで PDF をレンダリングする方法
IronPDF を使用すると、C# で ChromePdfRenderer クラスを利用し、SetCustomPaperSizeInInches() などのメソッドを通じて特定の寸法を設定することで、カスタム用紙サイズの PDF をレンダリングできます。これにより、ポスターやバナーなどの特殊なレイアウトにおいて、ドキュメントの寸法を精密に制御することが可能になります。
カスタム用紙サイズとは、A4やレターサイズ（8.5 x 11インチ）などの標準サイズではなく、ユーザーによって定義された非標準用紙サイズを指します。 カスタム用紙サイズは、ポスターやバナー、特別なドキュメントのように、特別なレイアウトが必要なドキュメントを印刷する際によく使用されます。 HTMLからPDFへの変換プロジェクトで特定の寸法を必要とする場合、この柔軟性は不可欠です。
IronPDFで利用可能な幅広い用紙サイズを探索し、あなたのニーズに合った選択を提供します！
クイックスタート: IronPDFでカスタム用紙サイズを定義する
このクイックガイドでは、IronPDFを使ってわずか数行のコードでカスタム用紙サイズを設定する方法を学びます。 IronPDFを使用すると、好きな単位で正確な幅と高さを定義することで、簡単にPDFの寸法を調整できます。 この柔軟性は、ポスターやバナーのように、独自のレイアウト要件を持つドキュメントを作成するのに理想的です。 NuGet経由でIronPDFライブラリをダウンロードすることから始め、この例に従って希望の用紙サイズを簡単に設定してください。
-
IronPDF をNuGetパッケージマネージャでインストール
PM > Install-Package IronPdf -
このコード スニペットをコピーして実行します。
var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } }; renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7); renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf") -
実際の環境でテストするためにデプロイする
今日プロジェクトで IronPDF を使い始めましょう無料トライアル
最小限のワークフロー（5ステップ）
- PDFにカスタム用紙サイズを設定するためのIronPDFをNuGetからダウンロードする。
- C#で
ChromePdfRendererクラスをインスタンス化します - 新しいオブジェクトの
RenderingOptionsにアクセスしてください - 測定単位に基づいて、
SetCustomPaperSizeメソッドのいずれかを呼び出します。 - PDF文書をレンダリングしてエクスポートします
標準的な用紙サイズを使用するにはどうすればよいですか?
まず、ChromePdfRendererクラスのインスタンスを作成します。 次に、新しく作成されたオブジェクトの RenderingOptions プロパティを使用して、PaperSize を変更します。 希望する用紙サイズを指定するには、PdfPaperSize列挙型の事前定義された値のいずれかに設定してください。利便性を考慮し、100種類以上の標準用紙サイズを事前に用意しています。
PDFレンダリングオプションで作業する場合、IronPDFはあなたのドキュメントがどのようにフォーマットされるかを包括的にコントロールします。 標準的な用紙サイズには、A4、レター、リーガル、多くの国際規格など、一般的に使用されているフォーマットが含まれます。
どの標準用紙サイズがありますか?
以下は標準用紙サイズを設定する例です：
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.csusing IronPdf;
using IronPdf.Rendering;
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");
pdf.SaveAs("standardPaperSize.pdf");Imports IronPdf
Imports IronPdf.Rendering
Private renderer As New ChromePdfRenderer()
' Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>")
pdf.SaveAs("standardPaperSize.pdf")IronPDFは以下のような標準的な用紙サイズを幅広くサポートしています：
- ISO216シリーズ：A0からA10、B0からB10
- 北米：レター、リーガル、タブロイド、エグゼクティブ
- アーキテクチャ：ANSI AからE
- 日本語：JIS B0からB10まで
- 封筒のサイズ：さまざまな国際封筒規格
利用可能な用紙サイズとその寸法の完全なリストについては、APIリファレンス・ドキュメントを参照してください。
用紙サイズを制御するプロパティは何ですか
PaperSize: PDFページの出力用紙サイズを、レター、A3、A4などの定義済みサイズに設定します。ForcePaperSize: HTMLからPDFを生成した後、ページサイズを調整することで、ページサイズをIronPdf.ChromePdfRenderOptions.PaperSizeで指定された値に正確に合わせます。 この機能は、用紙サイズを指定するCSSルールをバイパスするのに役立ちます。
これらのプロパティをカスタムマージンと組み合わせて使用すると、PDFレイアウトを正確に制御することができます。
異なる単位で標準的な用紙サイズを入手するにはどうすればよいですか?
標準用紙サイズの寸法を見つける必要がありますか？ ToMillimeters メソッドを使用すれば、これを簡単に実現できます。 このメソッドは、標準用紙サイズの幅と高さを Length オブジェクトとして含むタプルを返します。 Length クラスは非常に汎用性が高く、これらの寸法を次のような様々な単位に簡単に変換することができます：
- ミリメートル
- センチメートル
- インチ
- ピクセル
- ポイント
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size-in-other-unit.csusing IronPdf.Rendering;
double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();Imports IronPdf.Rendering
Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter()この機能は、CSSレスポンシブレイアウトと統合する場合や、カスタムレイアウトの正確な寸法を計算する必要がある場合に特に役立ちます。
カスタム用紙サイズを作成するにはどうすればよいですか?
まず、ChromePdfRenderer クラスをインスタンス化することから始めます。 新しく作成されたオブジェクトから、RenderingOptionsにアクセスして、生成されたばかりのPDFドキュメントにカスタム用紙サイズを適用することができます。 PDFページの出力用紙サイズを設定するために使用できる4つの方法があり、それぞれ異なる計測単位に基づいています：
SetCustomPaperSizeInCentimeters: 寸法はcentimeters単位です。SetCustomPaperSizeInInches: 寸法はinches単位です。SetCustomPaperSizeInMillimeters: 寸法はmillimeters単位です。SetCustomPaperSizeInPixelsOrPoints: 寸法はpixels or points単位です。
カスタム用紙サイズを作成するときは、ヘッダーとフッターやページの向きの設定とどのように相互作用するかを考慮することが重要です。
カスタム寸法にはどの単位を使用できますか?
以下はカスタム用紙サイズをセンチメートルで設定する例です：
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.csusing IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");
pdf.SaveAs("customPaperSize.pdf");Imports IronPdf
Private renderer As New ChromePdfRenderer()
' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>")
pdf.SaveAs("customPaperSize.pdf")以下は、各測定単位の追加例です：
// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);
// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size
// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);
// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size
// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI' Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5)
' Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420) ' A3 size
' Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96) ' 96 DPIカスタムサイズで作業する場合は、ビューポートとズームの設定を調べて、コンテンツがカスタムサイズ内に適切に収まるようにすることもできます。
紙の寸法を変更するにはどうすればよいですか?
既存のPDFドキュメントまたは新規に生成されたPDFにおいて、各ページのサイズは ExtendPage メソッドを使用して変更できます。 このメソッドを使用すると、対象のページインデックス、4辺それぞれを変更する値、および計測単位を指定できます。 それぞれの辺の値は負の値でその特定の辺を削減し、正の値でその辺を延長します。
この機能は、ページサイズの異なる複数のPDFを結合する場合や、印刷用のドキュメントを準備する場合など、PDFを作成した後で調整する必要がある場合に特に便利です。
ExtendPageはどのようなパラメータを受け付けますか?
ExtendPage メソッドは、以下のパラメータを受け付けます：
- ページインデックス: 修正するページのゼロベースのインデックス
- 左拡張: 左側を拡張/縮小する量
- 右拡張: 右側を拡張/縮小する量
- 上拡張: 上側を拡張/縮小する量
- 下拡張: 下側を拡張/縮小する量
- 測定単位: 測定単位 (
millimeters, inches, etc.)
以下は用紙寸法を変更する例です：
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.csusing IronPdf;
using IronPdf.Editing;
PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");
pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);
pdf.SaveAs( "extendedLeftSide.pdf");Imports IronPdf
Imports IronPdf.Editing
Private pdf As PdfDocument = PdfDocument.FromFile("customPaperSize.pdf")
pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter)
pdf.SaveAs("extendedLeftSide.pdf")以下は、さまざまなページの修正を示す、より包括的な例です：
// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);
// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);
// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);
// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);
// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);
// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);
// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);' Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter)
' Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter)
' Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter)
' Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch)カスタム用紙サイズのベストプラクティス
IronPDFでカスタム用紙サイズを使用する場合は、以下のベストプラクティスを考慮してください：
1.異なる単位をテストする：カスタムサイズで作業している間、どの測定単位がユースケースに最適かをテストしてください。 画面ベースのレイアウトにはピクセルが適していますが、印刷物にはミリメートルまたはインチが適しています。
2.印刷マージンを考慮する：印刷用にPDFを作成するときは、プリンタの余白を考慮することを忘れないでください。 ほとんどのプリンタは用紙の端まで印刷できません。
3.レスポンシブデザイン：HTML to PDFを変換するときは、HTMLがレスポンシブデザインの原則を使用して、さまざまな用紙サイズに適応するようにしてください。
4.パフォーマンスの最適化：非常に大きなカスタム用紙サイズはパフォーマンスに影響を与える可能性があります。 大きな文書には、圧縮の使用を検討してください。
5.互換性：カスタムサイズのPDFをさまざまなPDFビューアでテストし、互換性を確認してください。
次に何ができるのかを見てみましょうか？ ガイドページはこちら：Create PDFs
よくある質問
C# で PDF 文書にカ ス タ ムの用紙サ イ ズ を設定す る 方法は？
IronPDFではChromePdfRendererクラスを使ってカスタム用紙サイズを設定できます。RenderingOptionsでPaperSizeプロパティをPdfPaperSize.Customに設定し、SetCustomPaperSizeInInches()のようなメソッドを使って特定の寸法を定義します。たとえば、renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7)のようにします。
カスタム用紙サイズに使用できる測定単位は？
IronPDFは異なるSetCustomPaperSizeメソッドを通してカスタム用紙サイズのための複数の測定単位をサポートしています。インチ、センチメートル、ミリメートル、ピクセルで寸法を指定できるので、さまざまな国際規格やプロジェクトの要件に柔軟に対応できます。
標準サイズではなく、カスタムサイズを使用する必要があるのはどのような場合ですか？
IronPDFのカスタム用紙サイズは、ポスター、バナー、特殊なドキュメント、A4やレターのような標準フォーマットに合わないデザインのようなユニークなレイアウトのPDFを作成する際に理想的です。この柔軟性は、特定の寸法を必要とするHTMLからPDFへの変換プロジェクトで特に役立ちます。
定義済みの標準用紙サイズはいくつありますか？
IronPDFはPdfPaperSize列挙型を通じて、A4、レター、リーガル、多くの国際規格のような一般的に使用されるフォーマットを含む100以上の定義済みの標準用紙サイズを提供し、ほとんどのドキュメント要件に対応する包括的なオプションを提供します。
カスタム用紙サイズを実装する手順は？
IronPDFでカスタム用紙サイズを実装するには：1) NuGet経由でIronPDFをダウンロードし、2) ChromePdfRendererインスタンスを作成し、3) RenderingOptionsプロパティにアクセスし、4) SetCustomPaperSizeメソッドを希望の寸法で呼び出し、5) PDFドキュメントをレンダリングして保存します。
まだスクロールしていますか?
すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。
無料で始めましょう
無料で始めましょう
無料ライブデモを予約
クレジットカードやアカウントの作成は不要です。
