1. IronPDF
  2. 操作指南
  3. 自定义纸张大小
如何在 C# 中为 PDF 设置自定义纸张尺寸 | IronPDF

How to Render PDFs with Custom Paper Size

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

自定义纸张尺寸指的是由用户定义的非标准纸张尺寸，而不是像A4或信纸（8.5 x 11英寸）这样的标准尺寸。 自定义纸张尺寸通常用于打印需要独特或特定布局的文档，例如海报、横幅或专业文件。

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

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

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

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    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. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小化工作流程（5步）

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


使用标准纸张尺寸示例

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

代码

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

: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

相关属性

  • PaperSize：使用预定义的尺寸为PDF页面设置输出纸张尺寸，如信纸、A3、A4等。
  • ForcePaperSize：通过在从HTML生成的PDF之后调整页面大小，强制页面尺寸完全符合IronPdf.ChromePdfRenderOptions.PaperSize中指定的内容。 此功能有助于绕过指定纸张尺寸的CSS规则。

以不同单位获取标准纸张尺寸

需要找到标准纸张尺寸的尺寸吗？ 您可以轻松使用ToMillimeters方法做到这一点。 此方法返回一个包含标准纸张尺寸宽度和高度的元组，作为长度对象。 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

<hr

使用自定义纸张尺寸示例

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

  • SetCustomPaperSizeInCentimeters：尺寸以厘米为单位。
  • SetCustomPaperSizeInInches：尺寸以英寸为单位。
  • SetCustomPaperSizeInMillimeters：尺寸以毫米为单位。
  • SetCustomPaperSizeInPixelsOrPoints：尺寸以像素或点为单位。

代码

以下是如何以厘米为单位设置自定义纸张尺寸的示例：

: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

输出 PDF 文件

<hr

修改纸张尺寸示例

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

代码

以下是如何修改纸张尺寸的示例：

: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

输出 PDF 文件

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

常见问题解答

如何在C#中渲染具有自定义纸张尺寸的PDF？

要使用IronPDF渲染具有自定义纸张尺寸的PDF，请实例化ChromePdfRenderer类，访问RenderingOptions，并根据您偏好的测量单位（如厘米或英寸）使用SetCustomPaperSize方法之一。

下载用于自定义纸张尺寸设置的库有哪些步骤？

您可以通过NuGet下载IronPDF，以访问用于在PDF中设置自定义纸张尺寸的功能。此库提供了定义PDF文档特定尺寸所需的工具。

如何在PDF生成中应用标准纸张尺寸？

在IronPDF中，创建ChromePdfRenderer实例，然后使用RenderingOptions将PaperSize属性设置为PdfPaperSize枚举中的预定义值，如A4或信纸尺寸。

是否可以使用IronPDF修改现有PDF的页面大小？

是的，IronPDF允许您使用ExtendPage方法修改现有PDF的页面大小。此方法使您可以通过指定页面索引和测量单位来调整页面每一侧的尺寸。

在IronPDF中设置自定义纸张尺寸的选项有哪些？

IronPDF提供使用各种测量单位设置自定义纸张尺寸的方法：SetCustomPaperSizeInCentimeters、SetCustomPaperSizeInInches、SetCustomPaperSizeInMillimeters和SetCustomPaperSizeInPixelsOrPoints。

在PDF渲染中，ForcePaperSize特性如何工作？

IronPDF中的ForcePaperSize特性通过在从HTML渲染PDF后调整页面大小来确保实际页面尺寸与指定尺寸匹配。这有助于覆盖任何定义纸张尺寸的CSS规则。

IronPDF中有哪些预定义的纸张尺寸可用？

IronPDF提供了超过100种预定义纸张尺寸，包括常见的A3、A4和信纸尺寸，可以通过PdfPaperSize枚举选择。

如何使用IronPDF将标准纸张尺寸转换为不同单位？

您可以使用IronPDF的ToMillimeters方法将标准纸张尺寸转换为各种单位，如毫米、厘米、英寸、像素或点，为PDF设计提供灵活性。

IronPDF 是否完全兼容 .NET 10？我可以在 .NET 10 项目中使用自定义纸张尺寸功能吗？

是的，IronPDF 完全支持 .NET 10（包括其即将推出或最近发布的版本），您可以在 .NET 10 项目中使用自定义纸张尺寸指南中描述的所有功能（例如SetCustomPaperSizeInInches 、 SetCustomPaperSizeInMillimeters 、 ForcePaperSize等），而无需额外的变通方法或兼容性问题。

Chaknith Bin
Chaknith Bin
  立即与工程团队聊天
软件工程师
Chaknith 在 IronXL 和 IronBarcode 工作。他在 C# 和 .NET 方面有着深厚的专业知识，帮助改进软件并支持客户。他从用户互动中获得的见解有助于更好的产品、文档和整体体验。
准备开始了吗？
Nuget 下载 16,154,058 | 版本: 2025.11 刚刚发布