html2pdf中的C#頁面中斷修訂（開發者教程）

IronPDF：C# PDF程式庫

IronPDF是一個靈活、易於使用、可高度自訂的C# PDF程式庫，允許開發者，無論是初學者還是資深人士，完全操作和編輯PDF。 它為開發者提供了多種將不同格式（如HTML、RTF和Images）轉換為PDF的方式，並進一步編輯其在轉換為PDF時的渲染方式。 此外，IronPDF利用了Chrome渲染引擎，因此在渲染HTML字串時非常熟練，它允許開發者使用CSS樣式進一步自訂HTML文件，使以自訂性和視覺呈現的優勢脫穎而出，這是在其他地方找不到的。

由於該程式庫使用Chrome渲染引擎，您所見即所得，因此對於創建頁面分隔模板等操作非常理想，因此不會出現模板錯誤。 這正是您在將模板轉換為PDF時所設計的方式。

在PDF中添加頁面分隔

為了說明該程式庫的靈活性和易用性，我們將使用一個代碼示例來展示如何以編程方式添加頁面分隔。

在此情況下，我們將使用基於表格的PDF作為輸入，我們將看到立即添加頁面分隔和之後的視覺清晰度的差異。

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

使用CSS控制頁面分隔

由於IronPDF可以使用CSS進行自訂，因為它使用Chrome渲染引擎，所以我們可以利用這一點，使用CSS為特定元素添加頁面分隔，並在其中添加頁面分隔，還可以指定哪些元素不應在其中有頁面分隔。

例如，儘管在上圖中，頁面分隔出現在表格之後，但有時可能會因為混亂而在表格內出現。

為了避免這種情況，我們可以為節點使用特定的CSS樣式，並指定不希望在內部添加頁面分隔。

<div style='page-break-inside: avoid'>
 <img src='no-break-me.png'>
</div>

<div style='page-break-inside: avoid'>
 <img src='no-break-me.png'>
</div>

添加page-break-inside: avoid可防止在元素內部出現頁面分隔。 然而，在進行此操作時，確保將其應用於元素的父div節點。

類似的操作也可以用於希望添加頁面分隔前樣式的元素。

<div style="page-break-inside: avoid;">
    <img src="no-break-me.png">
</div>

<div style="page-break-inside: avoid;">
    <img src="no-break-me.png">
</div>

由於我們可以利用HTML，我們可以進一步指定節點的元素，通過使用JavaScript的document.getElementById選擇其ID以確保每個節點都可以完全自訂。

優化影像品質和文件大小

頁面分隔設置也與影像品質密切相關。 您希望確保頁面分隔設置不會通過縮放或按比例調整到下一頁來影響影像品質。

因此，我們可以使用CSS以確保在應用頁面分隔時，影像品質在模板中保持一致。

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

上述CSS樣式確保影像在頁面分隔操作後保持一致。 我們首先將寬度設置為頁面的100%，高度可以自動縮放以維持長寬比。

此外，IronPDF在處理HTML時具有其他渲染選項，類似於用戶的可下載可打印PDF提示的打印設置。有關完整的屬性列表，請參閱API文件。

使用JavaScript的對應方式

由於IronPDF具有使用Chrome渲染引擎的優勢，因此還有一個Node.js版本，允許各種背景的開發者使用這個強大的程式庫。

使用Node.js變體，開發者對於添加頁面分隔還有更精細的控制，因為您可以使用promise-based的用法和方法，例如onRejected promise方法用於調試或進度跟蹤及其中間函數。

與常見的html2pdf程式庫及其jsPDF物件的輸出方法相比，IronPDF更具靈活性和支持多種語言，允許具有不同語言專長的開發人員共同工作在同一專案上。

結論

了解如何使用頁面分隔以及CSS如何影響整體HTML在創建具有良好可呈現性和吸引力的文件對於用戶是至關重要的。 這能夠讓讀者將他們正在閱讀的資訊分開，以避免資訊過載和困惑。 在本文中，我們討論了如何利用IronPDF使用的強大Chrome渲染引擎來自動創建頁面分隔模板，這樣的模板和自動化能提高創建這些文件的效率和擴展性，並減少人為錯誤的風險。

對於想嘗試IronPDF的開發者，該程式庫提供免費試用，適用於$799及更高版本。