如何在 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);