如何使用 PDFSharp 在 C# (.NET 5) 中生成 PDF

安裝與設定

在進入程式碼之前，講者強調為 PDFsharp 設定環境可能相當具有挑戰性。 他們說明在使用 PDFsharp NuGet 套件詳細資訊之前，必須先安裝三個 NuGet 套件。 第一個套件是 PDFsharp 本身，由於其版本較舊，可能會產生與 .NET 不匹配的警告。 另外兩個軟體包是 System.Drawing.Common 和 System.Text.Encoding.CodePages。

講者強調，在使用 PDFsharp 之前，必須先安裝這三個套件；否則，程式碼會產生錯誤。 他們解釋說，System.Text.Encoding.CodePages 軟體包尤其重要，因為它提供了生成 PDF 文件所需的編碼支援。 講者還要指出，若無法正確安裝套件，就很難排除故障。 希望完全避免這種多軟體包設定的團隊可以按照PDFsharp 到IronPDF遷移指南進行逐步過渡。

建立 PDF 檔案

接下來，演講者展示了一個簡單的控制台應用程序，該程序使用 PDFsharp 生成 PDF 文件。他們解釋說，在使用該程式庫之前，必須聲明 PDFsharp Drawing 和 PDFsharp PDF 的 using 語句。 演講者接著會介紹產生 PDF 檔案的程式碼，其中包括建立新文件、新增頁面，以及在頁面上繪製文字。

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

Imports PdfSharp.Drawing
Imports PdfSharp.Pdf

Namespace PdfSharpExample
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a new PDF document
			Dim document As New PdfDocument()
			' Add a new page
			Dim page As PdfPage = document.AddPage()
			' Prepare to draw on the page
			Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
			' Define a font
			Dim font As New XFont("Verdana", 20, XFontStyle.Bold)

			' Draw a string to the page
			gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black, New XRect(0, 0, page.Width, page.Height), XStringFormats.Center)

			' Save the document
			Const filename As String = "HelloWorld.pdf"
			document.Save(filename)
		End Sub
	End Class
End Namespace

演講者指出，可以調整生成 PDF 文件的程式碼，使其包含更複雜的功能，例如添加圖像（請參閱如何使用 IronPDF將圖像轉換為 PDF ）、表格和圖表。 他們還解釋 PDFsharp 提供了各種處理字型的功能，包括在 PDF 檔案中嵌入字型。

講者解釋了正確設定環境的重要性，包括安裝必要的 NuGet 套件和註冊 System.Text.Encoding 的提供者。 他們還介紹了一個使用 PDFsharp 產生 PDF 檔案的簡單主控台應用程式，並示範如何調整程式碼以包含更複雜的功能。 對於任何有興趣使用 C# 和 PDFsharp 產生 PDF 檔案的人來說，這段影片是極佳的資源。

建立清單和更複雜的項目

在影片的第二部分，講者首先介紹一個較複雜的範例，即建立 PDF 文件。 他強調一個空的 PDF 文件是沒有意義的，接著解釋如何使用PDFSharp函式庫建立新的頁面。 他指出，這個過程與在 Excel 或 PowerPoint 附加元件中建立事物類似，一旦建立頁面，就能以不需要調用其他方法的參照來運作。

然後，演講者介紹了 XGraphics 變量，該變量提供了繪製文字、線條和圖像等內容的方法——IronPDF 透過其文字和圖像標記 API處理這些功能，而無需手動計算座標。 引入了 XFont 變量，用於設定 PDF 文件中使用的字體。 講者指出，字型可以在其他地方產生，但如果有更複雜的安排，在全局設定字型會很有用。

接下來，演講者討論了DrawString方法，該方法可以將文字寫入PDF檔案。他指出，該方法的困難在於確定文字的繪製位置，並解釋了涉及的各種參數，例如字體、顏色以及文字的對齊邊界。 他也解釋瞭如何使用 XBrushes 變數來設定文字顏色。

特點

IronPDF 的關鍵功能是它能夠使用IronPDF將 HTML 轉換為 PDF ，從而可以輕鬆地從網頁建立 PDF 文件。 HTML 到 PDF 的轉換不在 PDFsharp 目前的範圍內——它在坐標繪圖層級運行——因此需要此功能的團隊通常會添加單獨的渲染庫或評估IronPDF的內建 Chromium 引擎。

IronPDF 還支援數位簽章和帶密碼保護的 PDF 加密，這對於需要安全處理的敏感文件至關重要。 PDFsharp 並非旨在解決這些安全問題，因此有合規性或文件保護要求的團隊通常會發現這是一個評估IronPDF的自然轉折點。

與 PDFsharp 相比，IronPDF 提供了更廣泛的功能集和更全面的支援服務，在一個 NuGet 套件中涵蓋了 HTML 渲染、加密和數位簽章。 然而，它是一款商業產品，因此，對於需求符合 PDFsharp 座標繪圖模型，且不需要 HTML 轉換或內建安全功能的團隊來說，他們可能更喜歡 PDFsharp 的 MIT 授權的開源方法。

除了授權費用之外，專案總成本還包括開發人員花費在組裝獨立渲染庫、管理複雜文件的基於座標的頁面佈局以及解決 PDFsharp 所需的多軟體包設定問題上的時間。 對於評估多年專案生命週期成本的團隊來說，這些整合和維護成本往往超過開源授權和商業授權之間的差異。

準備好了解IronPDF如何融入您的工作流程了嗎？ 下載免費 30 天試用版，測試本對比中涵蓋的每項功能。