1. IronPDF
  2. 操作指南
  3. 分頁
如何在 HTML 到 PDF 轉換中處理 C# 的頁面分隔

使用 C# 在 HTML PDF 中新增或避免分頁符。

柯蒂斯·週
柯蒂斯·週
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

使用 C# 中的 IronPDF 將 HTML 轉換為 PDF 時，可透過在 HTML 元素中加入 page-break-after: always; 來控制 PDF 文件中的分頁符，或使用 page-break-inside: avoid; 來防止分頁符。

<！--說明：說明程式碼概念的圖表或截圖 -->

IronPDF支援PDF文件內的分頁符號。 PDF 文件和 HTML 文件的一個主要區別在於，HTML 文件可以捲動，而 PDF 文件是多頁的，可以列印。 當 將 HTML 字串轉換為 PDF 時，開發人員通常需要精確控制頁面斷裂的位置，以確保文件外觀專業。

快速入門：在 HTML 到 PDF 轉換中實作分頁符號

使用 IronPDF 將 HTML 轉換為帶分頁符的 PDF。 本範例示範在特定 HTML 內容後插入分頁符，以確保正確的分頁。 透過新增 page-break-after: always;樣式，開發人員可以控制分頁符號出現的位置，進而改善 PDF 文件的可讀性和組織性。

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

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

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer()
  .RenderHtmlAsPdf("<html><body><h1>Hello World!</h1><div style='page-break-after: always;'></div></body></html>")
  .SaveAs("pageWithBreaks.pdf");

  3. 部署到您的生產環境進行測試

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

最小工作流程（5 個步驟）

IronPDF promotional guide showing 4 steps for HTML PDF page breaks with NuGet install command
  1. 下載 C# 庫以在 PDF 中使用分頁符
  2. 将分页符应用于 HTML 字符串并将其转换为 PDF
  3. 設定 page-break-inside 屬性的avoid屬性，以避免在影像中出現分頁符號。
  4. 對表格做同樣的處理，以避免表格中的分頁符號
  5. 在 CSS 级别设置样式


如何在 HTML 到 PDF 中加入分頁符？

-->

<！--說明：顯示程式碼執行輸出或結果的截圖 -->

若要在 HTML 中建立分頁符號，請在 HTML 程式碼中使用此項：

<div style="page-break-after: always;"></div>
<div style="page-break-after: always;"></div>
HTML

當將 HTML 呈現為 PDF 時，page-break-after CSS 屬性是控制分頁的最可靠方法。 此屬性告訴 PDF 渲染器在包含此樣式的元素之後立即插入分頁符號。 在使用 自訂頁邊空白或特定頁面佈局時，分頁符可確保內容完全出現在預期位置。

為何 page-break-after 比其他方法更有效？ 在這個範例中，我的 HTML 中有以下表格和圖片，我希望在表格後加上分頁符，將它們分別放在兩個頁面上。 相較於 `page-break-before` 或手動間距等替代方案，`page-break-after` 屬性可在不同的呈現引擎中提供更一致的結果。 當建立 [ 具有複雜佈局的新 PDFs](https://ironpdf.com/how-to/create-new-pdfs/) 時，此方法可確保可預期的分頁。

分頁符應該使用哪些元素？ 分頁符可以有效地與 `
`, `
`, 和 `
` 等區塊層級元素搭配使用。 雖然您可以在各種 HTML 元素上套用分頁樣式，但以專用的 `
` 包覆內容可以提供最可靠的結果。 這一點在處理 [ 頁頭和頁尾](https://ironpdf.com/how-to/headers-and-footers/)時尤為重要，因為這些頁面需要一致地出現在各頁面中。 #### 桌子 ```html
CompanyProduct
Iron SoftwareIronPDF
Iron SoftwareIronOCR
``` #### 影像 ```html Ironpdf Logo Text Dotnet related to 如何在 HTML 到 PDF 中加入分頁符？ ```

如何在 C# 指令碼中實現分頁符號？ ```csharp :path=/static-assets/pdf/content-code-examples/how-to/html-to-pdf-page-breaks-page-break.cs ``` 上面的程式碼會產生一個有 2 頁的 PDF：表格在第一頁，圖片在第二頁：

如何防止圖片中斷頁？ 若要避免在圖片或表格中斷頁，請使用 CSS `page-break-inside` 屬性套用至包圍 `DIV` 元素。 當[使用 Chrome](https://ironpdf.com/how-to/pixel-perfect-html-to-pdf/)調試 HTML 時，此技術對於保持視覺完整性至關重要，可確保您的 PDF 完全按照預期的方式呈現。 ```html
No Break Me related to 如何在 HTML 到 PDF 中加入分頁符？
```

為什麼要用 DIV 元件包覆圖片？ 以 DIV 元素包覆圖片，可以更好地控制分頁行為。 `page-break-inside:avoid`屬性在區塊層級的元素上運作最可靠。 圖片預設為內嵌元素，因此包覆圖片可確保適當套用樣式。 這種方法在處理 [ 應答式 CSS](https://ironpdf.com/how-to/html-to-pdf-responsive-css/) 佈局時特別有用，因為這些佈局需要在 PDF 格式中維持其結構。

圖片分頁的常見問題有哪些？ 常見的問題包括圖片被分割到不同頁面、頁面邊界部分呈現，以及標題或相關文字遺失。 當圖片接近頁面底部時，常會發生這些問題。 使用 `page-break-inside: avoid` wrapper 可確保整個圖像及其容器以一個單元移動到下一個頁面，從而避免這些問題。 ```csharp using IronPdf; // Example showing how to prevent image breaks in a more complex layout const string htmlWithProtectedImage = @"

Our featured products are displayed below:

Product 1

Product 1 Description

Product 2

Product 2 Description

"; var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf(htmlWithProtectedImage); pdf.SaveAs("ProductGallery.pdf"); ```

如何避免表格中的分頁符號？ 如上所示，可以使用 CSS `page-break-inside: avoid` 來避免表格中的分頁符。 比起表格本身，最好將樣式套用於包裹的`DIV` ，以確保樣式套用於區塊級 HTML 節點。 在製作全面的 [HTML 轉 PDF 教學](https://ironpdf.com/tutorials/html-to-pdf/)時，正確的表格格式對於可讀性而言至關重要。

何時應該使用 thead 作為表格標題？ 若要在跨越多個 PDF 頁面的大型 HTML 表格的每一頁複製表頭和表腳，請在表格中使用 `` 群組： ```htmlC SharpVB``` `` 元素可確保表格跨越多頁時，表格標題會在每頁重複出現。 這對於財務報告、資料列表，以及任何需要在每頁都說明上下文的文件特別有用。 對於初始設定和 [安裝概述](https://ironpdf.com/get-started/installation-overview/)，IronPDF 會自動處理這些 HTML 標準。 ### Why Does Wrapping Tables in DIVs Matter? 使用分頁符控制將表格包覆在 DIV 元素中可提供幾種好處： - 必要時確保整個表格作為一個單元移動到下一頁 - 防止標題與資料行分開 - 允許額外的樣式與間距控制 - 讓添加標題或描述時更容易與表格保持一致

哪些進階 CSS3 設定可控制分頁？ 若要給予更大的控制權，請在 `thead` 群組之外使用 CSS3： ```html```

哪些 CSS 屬性最適合複雜的佈局？ 對於複雜的佈局，請結合多個 CSS 屬性： - `page-break-inside: avoid` - 防止元素分裂 - `page-break-after: always` - 在元素後面強制斷頁 - `page-break-before: always` - 強制在元素前斷頁 - `orphans` 和 `widows` - 控制分頁符的最小行數 - `break-inside`, `break-after`, `break-before` - 現代 CSS3 替代方案 這些屬性共同打造出具有適當流程與可讀性的專業 PDF。

如何排除分頁問題？ 當分隔頁無法如預期般運作時： 1.驗證您的 HTML 結構是否有效 2.檢查樣式是否套用至區塊層級的元素 3.先以簡單的範例進行測試，然後再增加複雜性 4.使用瀏覽器開發者工具檢查計算的樣式 5.考慮使用 IronPDF 的渲染選項以獲得更多控制權 請記住，不同的 PDF 渲染器在處理分頁符時可能會略有不同，因此使用您的特定用例進行測試對於在所有情況下取得一致的結果非常重要。