C# を使用して PDF のカスタム用紙サイズを設定する方法 | IronPDF

C#でカスタム用紙サイズで PDF をレンダリングする方法

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDFを使用すると、 ChromePdfRendererクラスを使用し、SetCustomPaperSizeInInches() などのメソッドを通じて特定の寸法を設定することで、C# でカスタム用紙サイズの PDF をレンダリングでき、ポスターやバナーなどの特殊なレイアウトのドキュメント寸法を正確に制御できます。

カスタム用紙サイズとは、A4やレターサイズ(8.5 x 11インチ)などの標準サイズではなく、ユーザーによって定義された非標準用紙サイズを指します。 カスタム用紙サイズは、ポスターやバナー、特別なドキュメントのように、特別なレイアウトが必要なドキュメントを印刷する際によく使用されます。 HTMLからPDFへの変換プロジェクトで特定の寸法を必要とする場合、この柔軟性は不可欠です。

IronPDFで利用可能な幅広い用紙サイズを探索し、あなたのニーズに合った選択を提供します!

クイックスタート: IronPDFでカスタム用紙サイズを定義する

このクイックガイドでは、IronPDFを使ってわずか数行のコードでカスタム用紙サイズを設定する方法を学びます。 IronPDFを使用すると、好きな単位で正確な幅と高さを定義することで、簡単にPDFの寸法を調整できます。 この柔軟性は、ポスターやバナーのように、独自のレイアウト要件を持つドキュメントを作成するのに理想的です。 NuGet経由でIronPDFライブラリをダウンロードすることから始め、この例に従って希望の用紙サイズを簡単に設定してください。

  1. IronPDF をNuGetパッケージマネージャでインストール

    PM > Install-Package IronPdf
  2. このコード スニペットをコピーして実行します。

    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")
  3. 実際の環境でテストするためにデプロイする

    今日プロジェクトで IronPDF を使い始めましょう無料トライアル

    arrow pointer


標準的な用紙サイズを使用するにはどうすればよいですか?

まず、ChromePdfRenderer クラスのインスタンスを作成します。 次に、新しく作成されたオブジェクトの RenderingOptions プロパティを使用して、PaperSize を変更します。 希望する用紙サイズを指定するには、PdfPaperSize列挙型の定義済み値のいずれかを設定します。お客様の利便性のために、100種類以上の標準用紙サイズが定義済みで用意されています。

PDFレンダリングオプションで作業する場合、IronPDFはあなたのドキュメントがどのようにフォーマットされるかを包括的にコントロールします。 標準的な用紙サイズには、A4、レター、リーガル、多くの国際規格など、一般的に使用されているフォーマットが含まれます。

どの標準用紙サイズがありますか?

以下は標準用紙サイズを設定する例です:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.cs
using 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");
$vbLabelText   $csharpLabel

IronPdfは以下のような標準的な用紙サイズを幅広くサポートしています:

  • ISO216シリーズ:A0からA10、B0からB10
  • 北米:レター、リーガル、タブロイド、エグゼクティブ
  • アーキテクチャ:ANSI AからE
  • 日本語:JIS B0からB10まで
  • 封筒のサイズ:さまざまな国際封筒規格

利用可能な用紙サイズとその寸法の完全なリストについては、APIリファレンス・ドキュメントを参照してください。

用紙サイズを制御するプロパティは何ですか

  • PaperSize: レター、A3、A4 などの定義済みサイズを使用して PDF ページの出力用紙サイズを設定します。
  • 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.cs
using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();
$vbLabelText   $csharpLabel

この機能は、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.cs
using 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");
$vbLabelText   $csharpLabel

以下は、各測定単位の追加例です:

// 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
$vbLabelText   $csharpLabel

カスタムサイズで作業する場合は、ビューポートとズームの設定を調べて、コンテンツがカスタムサイズ内に適切に収まるようにすることもできます。


紙の寸法を変更するにはどうすればよいですか?

既存の 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.cs
using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");
$vbLabelText   $csharpLabel

以下は、さまざまなページの修正を示す、より包括的な例です:

// 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);
$vbLabelText   $csharpLabel

カスタム用紙サイズのベストプラクティス

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ドキュメントをレンダリングして保存します。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 17,803,474 | バージョン: 2026.3 リリース
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。