1. IronPDF
  2. 操作指南
  3. 自定义纸张大小
如何使用自定义纸张尺寸渲染PDF

如何在 C# 中使用自定义纸张大小渲染 PDF

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF允许您使用SetCustomPaperSizeInInches()之类的方法设置特定尺寸来使用C#渲染具有自定义纸张尺寸的PDF，精确控制文档尺寸以便用于海报或横幅等特殊布局。

自定义纸张尺寸指的是由用户定义的非标准纸张尺寸，而不是像A4或信纸（8.5 x 11英寸）这样的标准尺寸。 自定义纸张尺寸通常用于打印需要独特或特定布局的文档，例如海报、横幅或专业文件。 在处理需要特定尺寸的 HTML 到 PDF 的转换项目时，这种灵活性至关重要。

通过IronPDF发现广泛的纸张尺寸选择，提供各种选项以满足您的需求！

快速入门：在IronPDF中定义自定义纸张尺寸

在本快速指南中，学习如何仅使用几行代码设置IronPDF的自定义纸张尺寸。 使用IronPDF，您可以通过定义任意单位的精确宽度和高度轻松定制PDF的尺寸。 这种灵活性非常适合创建具有独特布局要求的文档，如海报或横幅。 首先通过 NuGet 下载 IronPDF 库，然后按照此示例毫不费力地设置所需的纸张大小。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

    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

最小工作流程（5 个步骤）

  1. 从 NuGet 下载 IronPDF，用于在 PDF 中设置自定义纸张大小。
  2. 在C#中实例化ChromePdfRenderer 类
  3. 访问新对象的RenderingOptions
  4. 根据测量单位调用 SetCustomPaperSize 方法之一
  5. 渲染并导出PDF文档


如何使用标准纸张尺寸？

首先，创建一个ChromePdfRenderer类的实例。 然后，使用新创建对象的PaperSize。 将其设置为PdfPaperSize枚举的预定义值之一，以指定所需的纸张尺寸。我们为方便您提供了超过100个预定义的标准纸张尺寸。

在使用 PDF 渲染选项时，IronPDF 可全面控制文档的格式化方式。 标准纸张尺寸包括 A4、Letter、Legal 等常用格式以及许多国际标准。

有哪些标准纸张尺寸？

以下是设置标准纸张尺寸的示例：

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

IronPDF 支持大量标准纸张尺寸，包括

  • ISO 216 系列：A0 至 A10、B0 至 B10
  • 北美文：信函、法律文件、小报、行政文件
  • 架构：ANSI A 到 E
  • 日语：JIS B0 至 B10
  • 信封尺寸：各种国际信封标准

有关可用纸张尺寸及其尺寸的完整列表，请参阅 API 参考文档。

哪些属性控制纸张尺寸？

  • PaperSize：使用预定义尺寸（例如信纸、A3、A4等）设置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();
Imports IronPdf.Rendering

Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter()
$vbLabelText   $csharpLabel

在与CSS响应式布局集成时，或需要计算自定义布局的精确尺寸时，该功能尤其有用。

如何创建自定义纸张尺寸？

首先，我们开始实例化ChromePdfRenderer类。 从新创建的对象中，我们可以访问RenderingOptions以将自定义纸张尺寸应用于新生成的PDF文档。 有四种方法可用于设置PDF页面的输出纸张尺寸，每种方法基于不同的测量单位：

  • centimeters为单位。
  • inches为单位。
  • millimeters为单位。
  • 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");
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")
$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
' 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

在使用自定义尺寸时，您可能还需要探索视口和缩放设置，以确保您的内容在自定义尺寸内适合。

Icon Quote related to 自定义尺寸可以使用哪些单位？

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic related to 自定义尺寸可以使用哪些单位？

Milan Jovanovic

微软MVP

查看案例研究
Icon Quote related to 自定义尺寸可以使用哪些单位？

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle related to 自定义尺寸可以使用哪些单位？

Brent Matzelle

首席技术官，OPYN

查看案例研究
Icon Quote related to 自定义尺寸可以使用哪些单位？

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones related to 自定义尺寸可以使用哪些单位？

David Jones

首席软件工程师，Agorus Build

查看案例研究

如何修改纸张尺寸？

在已存在的PDF文档或新渲染的PDF中，可以使用ExtendPage方法修改每个页面的大小。 此方法允许您指定目标页面索引、各四边的修改值和测量单位。 每侧的值可以是负值，即减少该特定侧，也可以是正值，即延长该侧。

当您需要在创建 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");
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")
$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);
' 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 转换为 PDF 时，请确保您的 HTML 采用响应式设计原则，以适应不同的纸张尺寸。

4.性能优化：自定义纸张尺寸过大会影响性能。 考虑对大型文档使用 压缩。

5.兼容性：在不同的 PDF 阅读器中测试自定义大小的 PDF，以确保兼容性，尤其是在使用非标准尺寸的情况下。

准备好看看您还能做些什么吗？ 查看我们的教程页面：创建PDF

常见问题解答

如何在 C# 中为 PDF 文档设置自定义纸张大小？

using IronPDF，您可以使用 ChromePdfRenderer 类设置自定义纸张尺寸。只需将 RenderingOptions 中的 PaperSize 属性设置为 PdfPaperSize.Custom，然后使用 SetCustomPaperSizeInInches() 等方法定义特定尺寸即可。例如：renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7)。

自定义纸张尺寸可以使用哪些测量单位？

IronPDF 通过不同的 SetCustomPaperSize 方法支持自定义纸张尺寸的多种测量单位。您可以以英寸、厘米、毫米或像素为单位指定尺寸，从而灵活地满足各种国际标准和项目要求。

何时需要使用自定义纸张尺寸而不是标准尺寸？

IronPDF 中的自定义纸张尺寸是创建具有独特布局（如海报、横幅、专业文档或任何不适合 A4 或 Letter 等标准格式的设计）的 PDF 的理想选择。这种灵活性对于需要特定尺寸的 HTML 到 PDF 转换项目尤其有用。

有多少种预定义的标准纸张尺寸？

IronPDF 通过 PdfPaperSize 枚举提供了 100 多种预定义的标准纸张尺寸，包括 A4、Letter、Legal 等常用格式以及许多国际标准，为大多数文档需求提供了全面的选择。

实现自定义纸张尺寸的步骤是什么？

using IronPDF 实现自定义纸张尺寸：1) 通过 NuGet 下载 IronPDF，2) 创建一个 ChromePdfRenderer 实例，3) 访问 RenderingOptions 属性，4) 使用所需的尺寸调用 SetCustomPaperSize 方法，5) 渲染并保存 PDF 文档。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 20,296,129 | 版本: 2026.7 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。