C# PDFWriter教程，適用於.NET 10開發者

C# 中的 PDFWriter 是什麼？

PDFWriter 是一個文件物件或函式庫，它允許開發人員產生 PDF 文件、新增段落、圖像、標題以及以程式設計方式操作頁面。 傳統圖書館通常需要手動定位、複雜的運算和明確的資源管理。 他們可能還會遇到國際語言和複雜Unicode字元方面的困難。

IronPDF 簡化了這一切。 您可以使用熟悉的 C# 環境（無論是控制台應用程式、ASP.NET Core Web API 還是後台服務）中的簡單程式碼，根據 HTML 內容和 CSS 建立 PDF 文件。該程式庫會自動處理字體字距調整和元資料管理。

有些函式庫，如 iTextSharp，有一個名為 PdfWriter 的類，但在 C# 中，術語 PDFWriter 通常指的是以程式設計方式產生 PDF 文件的任何元件或函式庫。 IronPDF 採用了完全不同的方法：它不是透過底層 API 逐個元素地建立文檔，而是編寫 HTML 和 CSS，然後進行渲染。 這種方法意味著你可以在瀏覽器中建立佈局原型，並將其轉換為 PDF，而無需更改任何一行標記。

從低層次的操作轉向高層次的生成，可以顯著提高生產力。 使用 ChromePdfRenderer 實例，您可以用最少的程式碼建立 PDF。 Chrome 渲染引擎確保每次都能實現像素級完美輸出，支援現代 CSS 媒體類型和響應式佈局。

如下所示，傳統的 PDFWriter 函式庫（如 iTextSharp）需要大量的樣板程式碼，而 IronPDF 只需幾行程式碼即可產生相同的 PDF 文件——速度更快、更簡單、更不容易出錯。

如何在 C# 專案中安裝 IronPDF？

使用 IronPDF 入門只需不到一分鐘。 該軟體包可在NuGet.org上取得。 可透過 .NET CLI 或 NuGet 套件管理器控制台進行安裝：

dotnet add package IronPdf

dotnet add package IronPdf

或者，如果您喜歡使用 Visual Studio 中的 NuGet 套件管理器控制台：

Install-Package IronPdf

Install-Package IronPdf

或者，在 Visual Studio 中：

1.在"解決方案總管"中右鍵按一下專案 2.選擇"管理 NuGet 套件"。

3. 搜尋"IronPdf"
4. 點選安裝

有關特定平台的詳細安裝，請查看IronPDF 安裝指南和NuGet 套件設定演練。 如果您要部署到 Azure、AWS Lambda 或 Docker 容器，Iron Software 為每個平台維護了特定的環境指南。 Linux 部署可能需要額外的本機依賴項，文件中清楚地介紹了這些步驟。

安裝完成後，在文件頂部新增 using IronPdf;，即可開始產生 PDF。

如何使用 IronPDF 建立您的第一個 PDF 檔案？

與傳統的 PDFWriter 實作不同，IronPDF 不需要單獨的 PDFWriter 類別變數。 ChromePdfRenderer 和 PdfDocument 物件在內部處理所有寫入任務。 以下是使用 .NET 10 頂級語句的完整工作範例：

using IronPdf;

// Instantiate the PDF renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF!</p>");

// Save the PDF to disk
pdf.SaveAs("output.pdf");

using IronPdf;

// Instantiate the PDF renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF!</p>");

// Save the PDF to disk
pdf.SaveAs("output.pdf");

Imports IronPdf

' Instantiate the PDF renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF!</p>")

' Save the PDF to disk
pdf.SaveAs("output.pdf")

這就是全部節目內容。 ChromePdfRenderer 在內部處理所有複雜性，產生能夠準確反映 HTML 結構和樣式的 PDF。 您無需管理分頁符號、座標系或字形路徑——引擎會自動為您完成這些操作。

如果您需要處理流程而不是文件，您可以將 PDF 匯出為 MemoryStream:

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF!</p>");

// Work with the PDF as a byte array
byte[] pdfBytes = pdf.BinaryData;

// Or use the built-in stream
using var ms = pdf.Stream;
// Pass ms to an HttpResponse, Azure Blob Storage, or another destination

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF!</p>");

// Work with the PDF as a byte array
byte[] pdfBytes = pdf.BinaryData;

// Or use the built-in stream
using var ms = pdf.Stream;
// Pass ms to an HttpResponse, Azure Blob Storage, or another destination

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF!</p>")

' Work with the PDF as a byte array
Dim pdfBytes As Byte() = pdf.BinaryData

' Or use the built-in stream
Using ms = pdf.Stream
    ' Pass ms to an HttpResponse, Azure Blob Storage, or another destination
End Using

您也可以將 PDF 儲存為特定用途的專用格式：

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Archived Report</h1><p>Long-term storage version.</p>");

// Save as PDF/A-3b for long-term archival
pdf.SaveAsPdfA("archived-document.pdf", PdfAVersions.PdfA3b);

// Save as a linearized PDF for fast web viewing
pdf.SaveAsLinearized("web-optimized.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Archived Report</h1><p>Long-term storage version.</p>");

// Save as PDF/A-3b for long-term archival
pdf.SaveAsPdfA("archived-document.pdf", PdfAVersions.PdfA3b);

// Save as a linearized PDF for fast web viewing
pdf.SaveAsLinearized("web-optimized.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Archived Report</h1><p>Long-term storage version.</p>")

' Save as PDF/A-3b for long-term archival
pdf.SaveAsPdfA("archived-document.pdf", PdfAVersions.PdfA3b)

' Save as a linearized PDF for fast web viewing
pdf.SaveAsLinearized("web-optimized.pdf")

PDF/A 是ISO 19005 標準，用於規範文件的存檔質量，線性化的 PDF 透過允許逐頁串流傳輸，在 Web 瀏覽器中載入速度更快。 除了方法呼叫之外，這兩種方法都不需要額外的配置。

如何將HTML轉換為PDF文件？

IronPDF 的真正威力體現在產生複雜的 PDF 文件上。 無論是將現有網頁中的 HTML 轉換為 PDF，或是從範本建立動態報告，HTML 到 PDF 的轉換都能保持完整的 CSS 保真度。 該程式庫支援 Bootstrap、Flexbox、SVG 圖形和 JavaScript 渲染的內容。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert a live URL to PDF
var urlPdf = renderer.RenderUrlAsPdf("https://example.com");
urlPdf.SaveAs("website.pdf");

// Convert a local HTML file to PDF
var filePdf = renderer.RenderHtmlFileAsPdf("invoice.html");
filePdf.SaveAs("invoice.pdf");

// Apply rendering options for precise control
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500); // wait for dynamic content

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert a live URL to PDF
var urlPdf = renderer.RenderUrlAsPdf("https://example.com");
urlPdf.SaveAs("website.pdf");

// Convert a local HTML file to PDF
var filePdf = renderer.RenderHtmlFileAsPdf("invoice.html");
filePdf.SaveAs("invoice.pdf");

// Apply rendering options for precise control
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500); // wait for dynamic content

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Convert a live URL to PDF
Dim urlPdf = renderer.RenderUrlAsPdf("https://example.com")
urlPdf.SaveAs("website.pdf")

' Convert a local HTML file to PDF
Dim filePdf = renderer.RenderHtmlFileAsPdf("invoice.html")
filePdf.SaveAs("invoice.pdf")

' Apply rendering options for precise control
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(500) ' wait for dynamic content

當目標頁面依賴React或 Angular 等 JavaScript 框架，這些框架在初始 DOM 渲染之後填入內容時，WaitFor.RenderDelay 方法非常有用。 設定 500 - 1000 毫秒的延遲通常可以正確捕捉最終渲染狀態。

有關渲染選項的更多詳細信息，請參閱IronPDF 文件。

如何使用 IronPDF 產生真實世界的 PDF 文件？

在 C# 中，實際的 PDF 產生通常涉及動態資料。 以下是如何使用 IronPDF 建立專業發票的方法。 這個範例使用 C# 字串插值來建立 HTML 模板並直接渲染它：

using IronPdf;

int invoiceNumber = 12345;
decimal totalAmount = 250.75m;

string invoiceHtml = $@"
    <html>
    <head>
        <style>
            body {{ font-family: Arial, sans-serif; margin: 40px; }}
            .header {{ background: #f0f0f0; padding: 20px; border-radius: 4px; }}
            table {{ width: 100%; border-collapse: collapse; margin-top: 20px; }}
            td, th {{ padding: 8px 12px; border: 1px solid #ddd; }}
            .total {{ font-weight: bold; font-size: 18px; margin-top: 20px; }}
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #{invoiceNumber}</h1>
            <p>Date: {DateTime.Now:yyyy-MM-dd}</p>
        </div>
        <table>
            <tr><th>Product</th><th>Quantity</th><th>Price</th></tr>
            <tr><td>IronPDF License</td><td>1</td><td>$250.75</td></tr>
        </table>
        <p class='total'>Total: ${totalAmount:F2}</p>
    </body>
    </html>";

var renderer = new ChromePdfRenderer();
var invoicePdf = renderer.RenderHtmlAsPdf(invoiceHtml);

// Apply a digital signature for authenticity
invoicePdf.Sign(new PdfSignature("cert.pfx", "password"));
invoicePdf.SaveAs($"invoice-{invoiceNumber}.pdf");

using IronPdf;

int invoiceNumber = 12345;
decimal totalAmount = 250.75m;

string invoiceHtml = $@"
    <html>
    <head>
        <style>
            body {{ font-family: Arial, sans-serif; margin: 40px; }}
            .header {{ background: #f0f0f0; padding: 20px; border-radius: 4px; }}
            table {{ width: 100%; border-collapse: collapse; margin-top: 20px; }}
            td, th {{ padding: 8px 12px; border: 1px solid #ddd; }}
            .total {{ font-weight: bold; font-size: 18px; margin-top: 20px; }}
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #{invoiceNumber}</h1>
            <p>Date: {DateTime.Now:yyyy-MM-dd}</p>
        </div>
        <table>
            <tr><th>Product</th><th>Quantity</th><th>Price</th></tr>
            <tr><td>IronPDF License</td><td>1</td><td>$250.75</td></tr>
        </table>
        <p class='total'>Total: ${totalAmount:F2}</p>
    </body>
    </html>";

var renderer = new ChromePdfRenderer();
var invoicePdf = renderer.RenderHtmlAsPdf(invoiceHtml);

// Apply a digital signature for authenticity
invoicePdf.Sign(new PdfSignature("cert.pfx", "password"));
invoicePdf.SaveAs($"invoice-{invoiceNumber}.pdf");

Imports IronPdf

Dim invoiceNumber As Integer = 12345
Dim totalAmount As Decimal = 250.75D

Dim invoiceHtml As String = $"
    <html>
    <head>
        <style>
            body {{ font-family: Arial, sans-serif; margin: 40px; }}
            .header {{ background: #f0f0f0; padding: 20px; border-radius: 4px; }}
            table {{ width: 100%; border-collapse: collapse; margin-top: 20px; }}
            td, th {{ padding: 8px 12px; border: 1px solid #ddd; }}
            .total {{ font-weight: bold; font-size: 18px; margin-top: 20px; }}
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #{invoiceNumber}</h1>
            <p>Date: {DateTime.Now:yyyy-MM-dd}</p>
        </div>
        <table>
            <tr><th>Product</th><th>Quantity</th><th>Price</th></tr>
            <tr><td>IronPDF License</td><td>1</td><td>$250.75</td></tr>
        </table>
        <p class='total'>Total: ${totalAmount:F2}</p>
    </body>
    </html>"

Dim renderer As New ChromePdfRenderer()
Dim invoicePdf = renderer.RenderHtmlAsPdf(invoiceHtml)

' Apply a digital signature for authenticity
invoicePdf.Sign(New PdfSignature("cert.pfx", "password"))
invoicePdf.SaveAs($"invoice-{invoiceNumber}.pdf")

這種方法結合了 HTML 模板的靈活性和 PDF 輸出的可靠性。 您可以使用任何 CSS 框架，嵌入 base64 編碼的圖像，並將來自資料庫或 API 呼叫的資料直接注入到模板字串中。 最終產生的PDF文件格式專業，與瀏覽器中的HTML預覽完全一致。

使用 IronPDF 對 PDF 進行簽署時，會使用標準的 PFX 憑證文件，使其與 Windows 憑證儲存和第三方憑證授權單位相容。

如何添加頁首、頁尾和浮水印？

IronPDF 可以輕鬆地為產生的文件的每一頁添加專業的頁首、頁尾和浮水印。 這些配置是在渲染之前透過 RenderingOptions 進行的：

using IronPdf;

var renderer = new ChromePdfRenderer();

// Add an HTML-based header
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-family:Arial; font-size:12px;'>Annual Report 2025</div>",
    MaxHeight = 25
};

// Add a footer with automatic page numbers
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-size:10px;'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

// Generate a multi-page document to demonstrate the header/footer
string multiPageHtml = string.Empty;
for (int i = 1; i <= 5; i++)
{
    multiPageHtml += $@"
        <div style='page-break-after: always;'>
            <h2>Section {i}</h2>
            <p>This is section {i} of the report. Content continues here with supporting analysis and data.</p>
        </div>";
}

var report = renderer.RenderHtmlAsPdf(multiPageHtml);
report.SaveAs("annual-report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Add an HTML-based header
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-family:Arial; font-size:12px;'>Annual Report 2025</div>",
    MaxHeight = 25
};

// Add a footer with automatic page numbers
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-size:10px;'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

// Generate a multi-page document to demonstrate the header/footer
string multiPageHtml = string.Empty;
for (int i = 1; i <= 5; i++)
{
    multiPageHtml += $@"
        <div style='page-break-after: always;'>
            <h2>Section {i}</h2>
            <p>This is section {i} of the report. Content continues here with supporting analysis and data.</p>
        </div>";
}

var report = renderer.RenderHtmlAsPdf(multiPageHtml);
report.SaveAs("annual-report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Add an HTML-based header
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center; font-family:Arial; font-size:12px;'>Annual Report 2025</div>",
    .MaxHeight = 25
}

' Add a footer with automatic page numbers
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center; font-size:10px;'>Page {page} of {total-pages}</div>",
    .MaxHeight = 20
}

' Generate a multi-page document to demonstrate the header/footer
Dim multiPageHtml As String = String.Empty
For i As Integer = 1 To 5
    multiPageHtml &= $"
        <div style='page-break-after: always;'>
            <h2>Section {i}</h2>
            <p>This is section {i} of the report. Content continues here with supporting analysis and data.</p>
        </div>"
Next

Dim report = renderer.RenderHtmlAsPdf(multiPageHtml)
report.SaveAs("annual-report.pdf")

在渲染過程中，IronPDF 會自動取代 {page} 和 {total-pages} 標記。 您也可以使用 {date} 和 {time} 來表示動態時間戳記。

對於浮水印，IronPDF 使用 ApplyStamp() 方法，該方法接受基於 HTML 的印章定義。 這意味著您可以建立具有自訂字體、不透明度和旋轉角度的文字浮水印，或建立具有精確定位的圖像浮水印。 請參閱自訂浮水印指南以了解完整的配置選項。

如需對頁首和頁尾進行更多控制，請造訪頁首和頁尾文件。

IronPDF 提供哪些進階功能？

IronPDF 除了基本的 PDF 創建功能外，還具備廣泛的企業級功能。 下表總結了最常用的高階功能：

從 PDF 文件中提取文字是文件處理流程中的常見需求。 IronPDF 提供 PdfDocument.ExtractAllText() 用於提取完整文檔，並提供頁面級方法以實現更精細的存取。

合併或拆分 PDF 檔案只需要一次方法呼叫。 您可以將一組 PdfDocument 物件合併為一個對象，或將特定頁面提取到新文件中，而無需將整個文件載入到記憶體中。

可以使用標準的 <input>、<select> 和 <textarea> 元素在 HTML 中從頭開始建立PDF 表單，IronPDF 會將這些元素轉換為互動式 PDF 表單欄位。 現有表格也可以透過程式自動讀取和填寫。

IronPDF 也支援影像與 PDF 之間的轉換，使其適用於文件掃描工作流程、縮圖產生和影像歸檔流程。

如何獲得 IronPDF 的許可並進行部署？

IronPDF 需要許可證密鑰才能用於生產環境。 您可以在任何渲染調用之前，透過程式碼設定許可證密鑰：

using IronPdf;

// Set your license key before using any IronPDF features
License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Licensed Output</h1>");
pdf.SaveAs("licensed.pdf");

using IronPdf;

// Set your license key before using any IronPDF features
License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Licensed Output</h1>");
pdf.SaveAs("licensed.pdf");

Imports IronPdf

' Set your license key before using any IronPDF features
License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Licensed Output</h1>")
pdf.SaveAs("licensed.pdf")

提供免費試用許可證，無需信用卡。 它允許進行全功能評估，並在輸出結果上添加浮水印。 當您準備移除浮水印並部署到生產環境時，請查看授權頁面，以了解涵蓋單一開發人員、團隊和 OEM 部署方案的定價詳情。

對於部署環境：

• Windows IIS ：開箱即用，支援標準應用程式集區識別權限。
• Docker/Linux ：需要 IronPdf.Linux 或 IronPdf.Slim NuGet 包，其中捆綁了 Chromium 依賴項。
• Azure/AWS Lambda ：IronPDF 支援無伺服器部署，但 Chrome 引擎需要至少 512 MB 的記憶體分配才能穩定運作。
• macOS（Apple Silicon） ：最新版本已完全支援原生 ARM 二進位檔案。

IronPDF 功能頁面按部署環境提供了完整的功能細分。 對於複雜的渲染工作流程， IronPDF 文件包含架構圖和高並發應用程式的執行緒安全指南。

為什麼 IronPDF 是 .NET PDF 產生的實用選擇？

IronPDF 讓 C# 中的 PDF 產生變得簡單可靠。 你不需要專門的 PdfWriter 類； 相反，ChromePdfRenderer 和 PdfDocument 物件處理從 HTML 內容到頁面大小、頁首和頁腳的一切。 無論您是建立發票、報告還是證書，IronPDF 只需幾行程式碼即可完成這項工作。

HTML 轉換 PDF 方法具有實際的生產力優勢：您的範本是標準的 HTML 和 CSS 文件，您可以在瀏覽器中預覽和迭代，而無需重新建置。 設計正確時，只需將 IronPDF 指向相同的標記，即可獲得與瀏覽器預覽完全匹配的 PDF 檔案。

該庫支援高容量場景的平行處理和響應式應用程式的非同步操作。 您可以在後台服務中同時渲染數千個文檔，而不會阻塞請求線程。

憑藉完整的文檔、免費試用和快速回應的工程支持，入門非常簡單。 您可以輕鬆嘗試新的 PDF 文件、新增圖像或調整字體大小和頁面佈局。 IronPDF 將 PDF 創建從技術性工作轉變為您開發工作流程中的高效環節。

準備好實現 C# PDF 編寫工作流程的現代化了嗎？ 立即開始免費試用，體驗 IronPDF 如何簡化 .NET 10 中的 PDF 建立。憑藉完整的文件和快速回應的支持，您將在幾分鐘內（而不是幾小時）產生專業的 PDF 文件。

!{--01001100010010010100001001010010010000010101001001011001010111110100011101000101010101 01000101111101010011010101000100000101010010010101000100010101000100010111110101011101001000110 1010101000100100001011111010100000101001001001111010001000101010101010000110101010100101010101011 10101010001010010010010010010000010100110001011111010000100100110001001111101000011010010111111010000110100101110--