如何使用 C# 在 PDF 中添加頁碼

如何使用 C# 在 PDF 中加入頁碼

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 可讓您在 C# 中使用佔位符字串 {page}{total-pages} 在頁首/頁尾添加頁碼到 PDF 檔案中,並可選擇將它們套用到特定頁面或區段,以增強文件導覽功能。

頁碼是指分配給 PDF 文件中每頁的順序編號。 這些工具是導覽的重要元件,可協助讀者找到特定頁面並追蹤其位置。 頁碼也能方便引用和參考內容。 使用 IronPDF,在 PDF 中添加頁碼變得簡單直接。

<!--說明:說明程式碼概念的圖表或截圖 -->

快速入門:輕鬆地在 PDF 上新增頁碼

使用 IronPDF 在 PDF 文件中添加頁碼。 只需使用最少的 C# 程式碼,您就可以在頁首或頁尾插入動態頁碼,自訂其位置,並指定它們出現在哪些頁面上。 無論是處理新的 PDF 檔或是現有的 PDF 檔,IronPDF 都能提供靈活的解決方案,強化文件導覽與組織。

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

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    new IronPdf.ChromePdfRenderer { RenderingOptions = { HtmlFooter = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<center>{page}of{total-pages}</center>", DrawDividerLine = true } } }
         .RenderHtmlAsPdf("<h1>My multi-page document</h1><div style='page-break-after:always;'></div><h1>Page 2</h1>")
         .SaveAs("numbered-pages.pdf");
  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer


如何在 PDF 中加入基本頁碼? --> <!--說明:顯示程式碼執行輸出或結果的截圖 --> 使用占位符串 `{page}` 和 `{total-pages}` 與 **TextHeaderFooter** 或 **HtmlHeaderFooter** 類,您可以新增目前頁數和總頁數。 當 [ 建立新的 PDF](https://ironpdf.com/how-to/create-new-pdfs/) 或 [ 將 HTML 轉換為需要專業格式的 PDF](https://ironpdf.com/tutorials/html-to-pdf/) 文件時,此功能是不可或缺的。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-basic.cs ``` 上述程式碼產生的PDF檔案如下所示: 您也可以直接在 **ChromePdfRenderer** 的呈現選項中,新增頁首與頁尾的頁碼占位符字串。 在使用 [ 渲染選項](https://ironpdf.com/how-to/rendering-options/) 自訂 PDF 輸出時,這種方法非常有用。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-chromerenderer.cs ``` 在處理複雜的文件時,請考慮 [ 分頁符](https://ironpdf.com/how-to/html-to-pdf-page-breaks/) 和 [ 自訂頁邊](https://ironpdf.com/how-to/custom-margins/),以確保能正確顯示頁碼。

如何僅在特定頁面上新增頁碼? --> 使用 IronPDF,您可以控制頁碼的顯示位置。 使其從特定頁面開始,或應用於特定群組,例如偶數索引頁面。 在 [ 生成 PDF 報告](https://ironpdf.com/how-to/csharp-pdf-reports/)或處理包含不同部分的文件時,這種靈活性非常有價值。 首先,準備 PDF 文件以套用頁碼: ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-preparation.cs ```

如何僅對偶數頁進行編號? 在上一個範例的基礎上,此代碼將頁碼專門應用於偶數頁索引。 由於篩選是針對偶數頁索引,因此產生的 PDF 會在奇數頁號碼上顯示數字。 頁碼索引從零開始,頁碼從一開始。 此技術適合遵循傳統書籍格式的文件,或在處理 [ 合併 PDF 文件](https://ironpdf.com/how-to/merge-or-split-pdfs/)時使用。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-even-pages.cs ```

如何只對奇數頁進行編號? 在索引號為奇數的頁面上加入頁碼。 這種方式常見於雙面列印的情況,在這種情況下,頁碼應該只出現在列印文件的一面。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-odd-pages.cs ```

如何僅在最後一頁加入頁碼? 只在最後一頁加上頁碼。 這對摘要頁面或表示文件結束時非常有用。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-last-page-only.cs ```

如何僅在第一頁加入頁碼? 只需在第一頁新增頁碼。 這對於封面頁或只有第一頁需要識別的文件非常有效。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-first-page-only.cs ```

添加頁碼時,如何跳過第一頁? 應用頁眉時跳過第一頁。 此共同要求適用於有封面或標題頁的文件,這些頁面不應顯示頁碼。 在處理 [ IronPDF 表格](https://ironpdf.com/how-to/create-forms/)或包含求職信的文件時,此技術可確保格式的專業性。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page.cs ```

如何跳過第一頁,並在第二頁從 1 開始編號? 跳過第一頁,從第二頁開始編號,將其視為第一頁。此方法適用於封面頁不應計入頁碼順序的文件,例如學術論文或正式報告。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page-and-dont-count-it.cs ``` 若要探索所有的元資料選項,請造訪 [IronPDF 標頭與頁尾指南](https://ironpdf.com/how-to/headers-and-footers/#anchor-metadata-to-text-header-footer)。 ## 進階頁碼編排技巧 除了基本的頁面編號之外,IronPDF 還支援進階方案,包括 - **以節為基礎的編號**:針對不同的文件章節採用不同的編號方案 - **羅馬數字**:前言或附錄頁面的自訂格式 - **多重編號系統**:在單一文件中結合不同的編號方式 - **動態頁數**:當[新增或複製頁面](https://ironpdf.com/how-to/add-copy-delete-pages-pdf/)時更新總頁數 這些技巧在製作複雜文件(如技術手冊、學術論文或需要複雜頁數方案的法律文件)時很有價值。 ## 頁碼的最佳實務 在 PDF 中實施頁碼時,請考慮這些做法: 1.**一致性**:在整個文件中保持一致的定位和格式 2.**可讀性**:確保頁碼清晰可見,且不會與內容重疊。 3.**易讀性**:使用適當的字型大小和對比,以方便閱讀 4.**專業外觀**:使頁碼風格與您文件的整體設計相匹配 遵循這些指導方針並運用 IronPDF 靈活的頁碼編排功能,您就可以創建出符合特定要求的專業、有條理的 PDF 文件。

常見問題解答

如何在 C# 中將基本頁碼加到 PDF 中?

使用 IronPdf,您可以在 TextHeaderFooter 或 HtmlHeaderFooter 類別中使用占位符串 {page} 和 {total-pages} 來新增頁數。只需在您的頁首或頁尾 HTML 片段中包含這些占位符,IronPDF 就會在渲染 PDF 時自動將其替換為當前頁碼和總頁數。

我可以透過渲染選項直接新增頁碼嗎?

是的,您可以在 IronPDF 的 ChromePdfRenderer 的渲染選項中直接添加頁碼。這種方法允許您使用頁碼占位符串來設定頁首和頁尾,作為渲染配置的一部分,這在透過渲染選項自訂 PDF 輸出時特別有用。

哪些占位符串可用於頁面編號?

IronPDF 主要提供兩種頁碼占位字串:{page} 顯示目前的頁數,而 {total-pages} 則顯示文件的總頁數。當 PDF 被渲染時,這些占位符會自動被實際值取代。

我可以只在特定頁面上套用頁碼嗎?

是的,IronPDF 允許您控制頁碼在文件中的顯示位置。您可以指定哪些頁面應該顯示頁碼,使您能夠在封面頁中排除頁碼或僅在 PDF 的某些部分應用頁碼。

是否可以自訂頁碼的位置和樣式?

絕對可以。使用 IronPdf 的 HtmlHeaderFooter 類,您可以使用 HTML 和 CSS 自訂頁碼的位置、樣式和格式。您可以控制它們的位置、字型、大小、顏色,甚至添加分隔線或其他裝飾元素。

我可以在現有的 PDF 文件中加入頁碼嗎?

是的,IronPDF 支持在新 PDF 和现有 PDF 文档中添加页码。您可以載入現有的 PDF 文件,並套用帶有頁碼的頁首或頁尾,而無需從頭重新製作整個文件。

喬迪·巴迪亞
軟體工程師
喬迪精通Python、C#和C++,除了在Iron Software運用這些技能外,他還從事遊戲程式設計。他參與產品測試、產品開發和研究等工作,為產品的持續改進做出了巨大貢獻。豐富的經驗讓他始終保持挑戰性和工作熱情,他表示這是他最喜歡在Iron Software工作的原因之一。喬迪在佛羅裡達州邁阿密長大,畢業於佛羅裡達大學,主修電腦科學和統計學。
經審核
傑夫·弗里茨
傑弗裡·T·弗里茨
.NET 社群團隊首席專案經理
Jeff 同時也是 .NET 和 Visual Studio 團隊的首席專案經理。他是 .NET Conf 虛擬會議系列的執行製片人,並主持每週兩次的開發者直播節目“Fritz and Friends”,在節目中他會與觀眾一起探討技術並編寫程式碼。 Jeff 也為包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP Summit 在內的微軟大型開發者活動撰寫研討會、簡報並策劃內容。
準備好開始了嗎?
Nuget 下載 17,012,929 | 版本: 2025.12 剛剛發布