1. IronPDF
  2. 操作指南
  3. 自定義紙張大小
如何用 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 函式庫，並依照此範例毫不費力地設定所需的紙張大小。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 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`類別的一個實例。 然後，使用新建立物件的`RenderingOptions`屬性來修改`PaperSize` 。 將其設定為`PdfPaperSize`枚舉中的預定義值之一，即可指定所需的紙張尺寸。我們提供 100 多種預先定義的標準紙張尺寸，方便您使用。 在使用 [PDF 渲染選項](https://ironpdf.com/how-to/rendering-options/)時，IronPDF 可全面控制您的文件格式。 標準紙張尺寸包括 A4、Letter、Legal 等常用格式，以及許多國際標準。

哪些標準紙張尺寸可供選擇？ 以下是設定標準紙張尺寸的範例： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.cs ``` IronPDF 支援多種標準紙張尺寸，包括：： - **ISO 216 系列**：A0 至 A10、B0 至 B10 - **North American**：Letter, Legal, Tabloid, Executive - **架構**：ANSI A 到 E - **日文**：JIS B0 至 B10 - **信封尺寸**：各種國際信封標準 如需可用紙張尺寸及其尺寸的完整清單，請參閱 [API 參考文件](https://ironpdf.com/object-reference/api/)。

哪些屬性控制紙張尺寸？ - `PaperSize`: 設定 PDF 頁面的輸出紙張尺寸，預先定義的尺寸有 Letter、A3、A4 等。 - `ForcePaperSize`：從 HTML 產生 PDF 之後，透過調整頁面大小，強制頁面大小與透過 `IronPdf.ChromePdfRenderOptions.PaperSize` 所指定的完全相同。 此功能可用於繞過指定紙張尺寸的 CSS 規則。 將這些屬性與 [ 自訂頁邊](https://ironpdf.com/how-to/custom-margins/)結合使用時，您可以精確地控制 PDF 排版。

如何獲得不同單位的標準紙張尺寸？ 需要找標準紙張尺寸的尺寸嗎？ 您可以使用`ToMillimeters`方法輕鬆完成此操作。 此方法會以 `Length` 物件的形式傳回一個包含標準紙張尺寸寬度和高度的元組。 `Length` 類別具有令人難以置信的多樣性，讓您可以毫不費力地將這些尺寸轉換成各種單位，包括：： - 毫米 - 公分 - 吋數 - 像素 積分 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size-in-other-unit.cs ``` 此功能在整合 [CSS 響應式版面](https://ironpdf.com/how-to/html-to-pdf-responsive-css/)或需要計算自訂版面的精確尺寸時特別有用。

如何建立自訂紙張尺寸？ --> <！--說明：說明程式碼概念的圖表或截圖 --> 首先，我們實例化`ChromePdfRenderer`類別。 從新建立的物件，我們可以存取 `RenderingOptions` 來套用自訂的紙張尺寸到新產生的 PDF 文件。 設定 PDF 頁面輸出紙張尺寸的方法有四種，每種方法都以不同的計量單位為基礎： - `SetCustomPaperSizeInCentimeters` : 尺寸單位為`centimeters` 。 - `SetCustomPaperSizeInInches` : 尺寸單位為`inches` 。 - `SetCustomPaperSizeInMillimeters` : 尺寸單位為`millimeters` 。 - `SetCustomPaperSizeInPixelsOrPoints` : 尺寸單位為`pixels or points` 。 在建立自訂紙張尺寸時，必須考慮它們將如何與 [ 標頭和頁尾](https://ironpdf.com/how-to/headers-and-footers/)以及 [ 頁面方向設定](https://ironpdf.com/how-to/page-orientation-rotation/)互動。

自訂尺寸可以使用哪些單位？ 以下是如何以公分為單位設定自訂紙張尺寸的範例： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.cs ``` 以下是每個測量單位的其他範例： ```csharp // 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 ``` 在使用自訂尺寸時，您可能還需要探索 [viewport 與縮放設定](https://ironpdf.com/how-to/viewport-zoom/)，以確保您的內容能在自訂尺寸內正確貼合。

如何修改紙張尺寸？ 在現有的 PDF 文件或新渲染的 PDF 中，可以使用`ExtendPage`方法修改每一頁的大小。 此方法可讓您指定目標頁面索引、要修改的四個邊的值以及計量單位。 每邊的值可以是負數（這將減少該邊）或正數（這將增加該邊）。 當您在建立 PDF 後需要調整 PDF 時，例如合併多個頁面大小不同的 PDF 或準備文件列印時，此功能尤其有用。

ExtendPage 接受哪些參數？ `ExtendPage` 方法接受下列參數： - **頁面索引**：要修改的頁面的零基索引 - **左側延伸**：擴展/縮小左側的金額 - **右側延伸**：擴展/縮小右側的金額 - **頂端延伸**：擴展/縮小頂端面的金額 - **底部延伸**：擴展/縮小底面的金額 - **測量單位**：測量單位（`毫米、英吋等`）。 以下是修改紙張尺寸的範例： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.cs ``` 以下是一個更全面的範例，顯示各種頁面修改： ```csharp // 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); ``` ## 自訂紙張尺寸的最佳實務 在 IronPDF 中使用自訂紙張尺寸時，請考慮這些最佳實務： 1.**測試不同的單位**：在使用自訂尺寸時，請測試哪一種測量單位最適合您的使用個案。 像素非常適合螢幕型版面，而毫米或英吋則較適合印刷。 2.**考慮列印邊界**：在建立 PDF 用於列印時，請記得考慮印表機邊距。 大多數印表機無法列印到紙張邊緣。 3.**反應式設計**：在轉換 [HTML 至 PDF](https://ironpdf.com/how-to/html-file-to-pdf/) 時，請確保您的 HTML 採用回應式設計原則，以適應不同的紙張尺寸。 4.**效能最佳化**：非常大的自訂紙張尺寸可能會影響效能。 考慮對大型文件使用 [ 壓縮](https://ironpdf.com/how-to/pdf-compression/)。 5.**相容性**： 在不同的 PDF 檢視器中測試您自訂尺寸的 PDF，以確保相容性，尤其是在使用非標準尺寸的情況下。 準備好看看您還能做些什麼嗎？ 請造訪我們的教學頁面：[建立 PDF](https://ironpdf.com/tutorials/csharp-create-pdf-complete-tutorial/)

常見問題解答

如何在 C# 中為 PDF 文件設定自訂紙張大小？

使用 IronPDF，您可以使用 ChromePdfRenderer 類別設定自訂紙張尺寸。只需在 RenderingOptions 中將 PaperSize 屬性設定為 PdfPaperSize.Custom，然後再使用 SetCustomPaperSizeInInches() 等方法來定義您的特定尺寸。例如：renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7)。

自訂紙張尺寸可以使用哪些測量單位？

IronPDF 透過不同的 SetCustomPaperSize 方法，支援自訂紙張尺寸的多種測量單位。您可以指定以英吋、公分、毫米或像素為單位的尺寸，因此可以靈活地滿足各種國際標準和專案需求。

何時需要使用自訂紙張尺寸而非標準尺寸？

IronPdf 中的自定紙張尺寸是製作具有獨特佈局的 PDF 的理想選擇，例如海報、橫幅、專業文件或任何不適合 A4 或 Letter 等標準格式的設計。這種靈活性對於需要特定尺寸的 HTML 至 PDF 轉換專案尤其有用。

有多少預定義的標準紙張尺寸？

IronPDF 透過 PdfPaperSize 枚舉提供超過 100 種預定義的標準紙張尺寸，包括 A4、Letter、Legal 等常用格式，以及許多國際標準，為大多數的文件需求提供全面的選擇。

實現自訂紙張尺寸的步驟是什麼？

要使用 IronPDF 實現自定義紙張大小：1) 透過 NuGet 下載 IronPdf，2) 建立一個 ChromePdfRenderer 實例，3) 存取 RenderingOptions 屬性，4) 以您所需的尺寸呼叫 SetCustomPaperSize 方法，5) 渲染並儲存您的 PDF 文件。

柯蒂斯·週
柯蒂斯·週
  現在就和工程團隊聊天吧
技術撰稿人

Curtis Chau擁有卡爾頓大學電腦科學學士學位，專長於前端開發，精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面，喜歡使用現代框架，並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

除了開發工作之外，柯蒂斯對物聯網 (IoT) 也抱有濃厚的興趣，致力於探索硬體和軟體整合的創新方法。閒暇時，他喜歡玩遊戲和製作 Discord 機器人，將他對科技的熱愛與創造力結合。

準備好開始了嗎？
Nuget 下載 17,012,929 | 版本： 2025.12 剛剛發布