如何在 C# 中渲染具有自訂紙張尺寸的 PDF

有哪些標準紙張尺寸可供選擇？

以下是設定標準紙張尺寸的範例：

: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");

IronPDF支援多種標準紙張尺寸，包括：

• ISO 216 系列：A0 至 A10，B0 至 B10 -北美：信函、法律、小報、行政 -建築：符合 ANSI A 至 E 標準 -日文：JIS B0 至 B10 信封尺寸：各種國際信封標準

有關可用紙張尺寸及其尺寸的完整列表，請參閱API 參考文件。

哪些因素決定紙張尺寸？

• PaperSize: 為 PDF 頁面設定輸出紙張尺寸，預先定義尺寸包含 letter、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.cs

using IronPdf.Rendering;

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

當需要整合CSS 響應式佈局或計算自訂佈局的精確尺寸時，此功能尤其有用。

自訂尺寸可以使用哪些單位？

以下是如何以公分為單位設定自訂紙張尺寸的範例：

: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");

以下是每個計量單位的更多範例：

// 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

使用自訂尺寸時，您可能還需要檢查視窗和縮放設置，以確保您的內容能夠正確地適應自訂尺寸。

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");

以下是一個更全面的範例，展示了各種頁面修改：

// 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);