影片

如何在 C#| IronPDF 中從模板生成 PDF

Curtis Chau
Curtis Chau
Updated: 2026年7月19日

從RawPrint轉移到IronPDF與其說是一種替換，不如說是一種改造：RawPrint和IronPDF解決不同的問題，對於大多數團隊來說，誠實的表述應該是"補充"，而不是"替換"。本指南將介紹IronPDF如何真正替代原有的RawPrint管道（在Windows上建立PDF然後推送的工作流程），並標示出應保留RawPrint的情況（ESC/POS，ZPL，EPL，原生PCL）。

為何從RawPrint轉移到IronPDF

了解RawPrint

RawPrint是一個NuGet包RawPrint (frogmorecs/RawPrint, v0.5.0，最後發佈於2019年9月，現在在nuget.org上未列出/過時)。 它是winspool.Drv之上的一個薄P/Invoke包裝器，將字節流直接傳送到Windows的RAW型別資料列印緩衝區。 公共API很小：在PrintRawStream重載。 底層Win32調用（ClosePrinter）隱藏在該接口之後——在使用包時，您不需要自己編寫它們。

這使得RawPrint非常適合ESC/POS收據列印機、ZPL/EPL斑馬標籤列印機和您已經生成了列印機固件預期字節的舊PCL/PostScript作業。 對於針對Windows特定環境並需要直接列印機通信的開發人員來說，RawPrint提供了一種有效的途徑，繞過了驅動程式或圖形介面等中介層。

然而，RawPrint不是一個PDF程式庫——它只將資料推送到列印機。 如果您的應用程式目前使用其他程式庫建立PDF然後將其交給RawPrint，整個管道通常可以在Windows上整合為IronPDF。

核心問題：無PDF建立功能

RawPrint具有顯著的限制，使其不適合現代文件工作流程：

  1. 無PDF建立功能： RawPrint專注於資料傳輸，缺乏PDF建立、渲染或操作的功能。

  2. 非常底層： 由於直接處理原始字節，開發人員必須對列印機的命令語言有深入了解，這使得它不太適合簡單的文件列印任務。

  3. 平台特定： 依賴於Windows列印緩衝區，限制了其跨平台的適用性。

  4. 無文件處理： 僅僅是字節傳輸，沒有渲染功能。

  5. 控制限制： 列印作業配置選項極少。

RawPrint與IronPDF對比

功能RawPrintIronPDF
功能性直接將原始列印資料發送到列印機全面的PDF建立和操作
使用案例專業化列印如標籤通用文件管理和建立
平台依賴性Windows特定跨平台
複雜性底層，需要列印機命令知識高層，使用者友好的API
PDF建立否是
從HTML建立PDF否是
從URL建立PDF否是
編輯/修改PDF否是
合併/拆分PDF否是
列印已有PDF是（原始字節）是（高層API）
列印控制基本全選項
理想物件直接列印機存取需求網路和桌面應用中的PDF相關任務
靈活性由於處理原始字節而限制具有多種功能的廣泛靈活性

與RawPrint截然不同，IronPDF提供了一個強大而多才多藝的API來全面處理PDF。 作為.NET環境中的著名名稱，IronPDF允許開發人員輕鬆地在各個平台上建立、編輯和轉換PDF。

對於針對現代.NET的團隊來說，IronPDF提供了RawPrint設計上不具備的跨平台相容性。

開始之前

前提條件

  1. .NET環境：.NET Framework 4.6.2+ 或.NET Core 3.1+ / .NET 5/6/7/8/9+
  2. NuGet存取： 有能力安裝NuGet套件
  3. IronPDF授權： 從ironpdf.com獲取您的授權金鑰

NuGet包變更

# Remove RawPrint
dotnet remove package RawPrint

# Install IronPDF
dotnet add package IronPdf
SHELL

授權配置

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

查找RawPrint用法

# Identify allRawPrintusage
grep -r "using RawPrint" --include="*.cs" .
grep -r "PrintRawFile\|PrintRawStream" --include="*.cs" .
SHELL

注意：手工撰寫的P/Invoke包裝器圍繞RawPrinterHelper，看起來與RawPrint用法表面上類似，但這不是包——它們直接調用Win32緩衝區。 包本身僅公開PrintRawStream。

完整API參考

名稱空間變更

// Before: RawPrint
using RawPrint;

// After: IronPDF
using IronPdf;

核心API對應

RawPrint (真實公共API)IronPDF注釋
new Printer() / IPrinternew ChromePdfRenderer() / PdfDocumentRawPrint推送字節； IronPDF生成PDF
printer.PrintRawFile(name, path, paused)PdfDocument.FromFile(path).Print()IronPDF重新渲染到操作系統的列印系統； 不是RAW
printer.PrintRawStream(name, stream, doc, paused)new PdfDocument(stream).Print()相同的警告
printer.OnJobCreated事件不適用改用IronPDF列印選項
不適用ChromePdfRenderer.RenderHtmlAsPdf()建立PDF
不適用PdfDocument.Merge()合併PDF
不適用pdf.ApplyWatermark()新增水印

IronPDF通過將文件文件交給操作系統來列印，而不是將原始字節流傳到緩衝區。 如果您的列印機需要RAW的資料型別（ESC/POS，ZPL，特定的PCL工作流程），那是RawPrint的領域，IronPDF不能代替。

程式碼遷移範例

範例1：HTML轉PDF轉換

之前（RawPrint）：

// NuGet: Install-Package RawPrint
using System;
using System.IO;
using System.Text;
using RawPrint;

class Program
{
    static void Main()
    {
        //RawPrintcannot convert HTML to PDF. Sending raw HTML bytes to a printer just
        // prints the HTML source as text — the markup is not rendered.
        string html = "<html><body><h1>Hello World</h1></body></html>";
        byte[] data = Encoding.ASCII.GetBytes(html);

        IPrinter printer = new Printer();
        using (var stream = new MemoryStream(data))
        {
            // PrintRawStream(printerName, stream, documentName, paused)
            printer.PrintRawStream("Microsoft Print to PDF", stream, "HTML Document", false);
        }
        Console.WriteLine("Raw HTML bytes sent to spooler (not rendered).");
    }
}

之後（IronPDF）：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

即使使用包本身的友好API，也能看到架構的不匹配：RawPrint使用RAW資料型別將字節流傳到Windows的緩衝區，因此將HTML交給它只會導致列印機列印源文字。 IronPDF的ChromePdfRenderer實際上渲染了標記。請參閱HTML轉PDF文件以獲取全面的例子。

範例2：URL轉PDF轉換

之前（RawPrint）：

// NuGet: Install-Package RawPrint
using System;
using System.IO;
using System.Net.Http;
using System.Text;
using RawPrint;

class Program
{
    static void Main()
    {
        //RawPrintcannot fetch a URL or render a web page; downloading the HTML and
        // shipping it to the spooler just prints the raw HTML source.
        using (var client = new HttpClient())
        {
            string htmlSource = client.GetStringAsync("https://example.com").GetAwaiter().GetResult();
            byte[] data = Encoding.UTF8.GetBytes(htmlSource);

            IPrinter printer = new Printer();
            using (var stream = new MemoryStream(data))
            {
                printer.PrintRawStream("Microsoft Print to PDF", stream, "Web Page", false);
            }
            Console.WriteLine("Raw HTML sent to spooler (not a rendered PDF).");
        }
    }
}

之後（IronPDF）：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        // Render a live website directly to PDF with full CSS, JavaScript, and images
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Website rendered to PDF successfully");
    }
}

RawPrint不能渲染網頁——它只將字節流傳到緩衝區。 下載HTML並推送它最終會導致列印機列印源文字，而不是渲染內容。 IronPDF的RenderUrlAsPdf()捕獲了完整渲染的網頁，包括CSS、JavaScript和圖像。 在我們的教程中了解更多。

例3：文件格式化

之前（RawPrint）：

// NuGet: Install-Package RawPrint
using System;
using System.IO;
using System.Text;
using RawPrint;

class Program
{
    static void Main()
    {
        //RawPrinthas no concept of fonts, margins, or layout — formatting must be
        // expressed in the printer's own command language (PCL, PostScript, ESC/POS, ZPL).
        // Example: a tiny PCL5 stream that selects portrait and a 16.66cpi font.
        string pclCommands = "\x1B&l0O\x1B(s0p16.66h8.5v0s0b3T";
        string text = "Plain text document - formatting must be expressed in printer command language";
        byte[] data = Encoding.ASCII.GetBytes(pclCommands + text);

        IPrinter printer = new Printer();
        using (var stream = new MemoryStream(data))
        {
            printer.PrintRawStream("HP LaserJet", stream, "Raw Document", false);
        }
    }
}

之後（IronPDF）：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        string html = @"
            <html>
            <head>
                <style>
                    body { font-family: Arial; margin: 40px; }
                    h1 { color: #2c3e50; font-size: 24px; }
                    p { line-height: 1.6; color: #34495e; }
                    .highlight { background-color: yellow; font-weight: bold; }
                </style>
            </head>
            <body>
                <h1>Formatted Document</h1>
                <p>This is a <span class='highlight'>beautifully formatted</span> document with CSS styling.</p>
                <p>Complex layouts, fonts, colors, and images are fully supported.</p>
            </body>
            </html>";
        
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("formatted.pdf");
        Console.WriteLine("Formatted PDF created successfully");
    }
}

使用RawPrint，格式化超出普通字節意味着手工撰寫列印機命令序列如"\x1B&l0O\x1B(s0p16.66h8.5v0s0b3T"並了解目標列印機的PCL或PostScript方言。 IronPDF使用標準的HTML和CSS——複雜的佈局、字型、顏色和圖像都被完全支持，無需特定於列印機的知識。

功能比較總結

功能RawPrintIronPDF
PDF建立
HTML轉PDF否是
URL到PDF否是
從頭建立否是
PDF 操作
合併PDF否是
拆分PDF否是
新增水印否是
編輯現有文件否是
列印
將RAW字節推送到緩衝區是否
ESC/POS，ZPL，原始PCL是否
通過操作系統列印系統列印否是
平台
Windows是是
Linux否是
macOS否是
Docker否是
其他
加密/安全否是
數位簽名否是
PDF/A否是

遷移後的新能力

遷移到IronPDF後，您將獲得RawPrint無法提供的能力：

PDF合併

var pdfs = pdfFiles.Select(f => PdfDocument.FromFile(f)).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs("complete.pdf");

設定列印

var pdf = PdfDocument.FromFile("report.pdf");

pdf.Print(new PrintOptions
{
    PrinterName = "HP LaserJet",
    NumberOfCopies = 2,
    DPI = 300,
    GrayScale = false
});

在一個工作流程中建立和列印

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(@"
    <h1>Invoice #12345</h1>
    <p>Customer: John Doe</p>
    <p>Amount: $150.00</p>
");

// Print directly
pdf.Print("HP LaserJet");

// Or save first
pdf.SaveAs("invoice.pdf");

遷移檢查表

遷移前

  • 識別所有RawPrint用法（PrintRawStream）
  • 分類每個調用位置：要發送到辦公室列印機的PDF是IronPDF的候選者； ESC/POS，ZPL，EPL或手工製作的PCL/PostScript字節應保留在RawPrint
  • 記錄您應用中使用的列印機名稱——IronPDF通過操作系統列印系統列印，因此名稱仍需解析
  • 記錄任何可以合併的外部PDF建立程式碼
  • 獲取IronPDF授權金鑰來自ironpdf.com

程式碼更新

  • 安裝IronPDF套件：dotnet add package IronPdf
  • 僅在沒有剩餘原始字節通道的情況下才能刪除RawPrint：dotnet remove package RawPrint
  • 將建立後再原始列印管道替換為pdf.Print()
  • 將PDF建立和列印整合到Windows上的單一工作流程中
  • 在應用程式啟動時新增授權初始化

測試

  • 測試列印到目標列印機
  • 驗證列印質量
  • 測試多份副本
  • 測試靜默列印
  • 如有必要，進行跨平台驗證
請注意: RawPrint是其各自擁有者的註冊商標。 本網站與RawPrint沒有任何關聯，不被其認可或贊助。 所有產品名稱、標誌和品牌均為其各自所有者的財產。 比較僅供參考，反映撰寫時公開可用的資訊。
Curtis Chau
Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

閱讀更多

相關文章