影片

如何在 C# | IronPDF 中將 HTML ZIP 檔渲染為 PDF

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

VectSharp（由Giorgio Bianchini開發，arklumpus/VectSharp）是一個輕量的跨平台向量圖形程式庫，適用於.NET Standard 2.0，通常用於科學可視化和技術插圖。 當開發團隊需要生成商業文件、報告、發票或基於HTML的內容時，VectSharp的圖形為先範例會產生摩擦。 它被設計用於繪製圖形和圖表，而不是生成文件。

本指南提供了從VectSharp遷移到IronPDF的完整路線圖，包含逐步指導、程式碼比較以及為評估此轉換的專業.NET開發者提供的實用例子。

為什麼要從VectSharp遷移

VectSharp是一個向量圖形程式庫，設計用來建立圖表、圖示和技術插圖，具有可插入的輸出層，包括VectSharp.Raster。 它不是為了文件生成而設計的 - 這是一個繪圖程式庫，其Document上。 開發團隊考慮遷移的主要原因包括：

僅限科學專注：VectSharp是專為資料可視化和繪圖設計的，而不是商業文件如發票、報告或證書。

不支持HTML：VectSharp無法將HTML或CSS轉換為PDF。 每個元素都必須使用向量圖形命令手動繪製。

基於座標的API：每個元素都必須以精確的X,Y座標定位。 沒有自動佈局、流動或文字換行功能。

不支持CSS樣式：所有的樣式都是通過方法調用編程的。 網頁開發者不能利用他們現有的CSS知識。

不支持JavaScript：VectSharp無法渲染動態網頁內容、交互式圖表或基於JavaScript的可視化。

不支援文字佈局：自動文字換行、分頁和流動佈局不可用。 開發者必須手動計算文字位置和頁面分隔。

**圖形為先： **這個程式庫是為繪圖而設計的，不是為報告或發票設計的。 文件生成需要大量手動工作。

核心問題：圖形程式庫對比文件生成器

VectSharp要求每個元素都進行手動向量繪製：

// VectSharp: 手動 vector drawing for every element
Page page = new Page(595, 842);
Graphics graphics = page.Graphics;
graphics.FillRectangle(50, 50, 200, 100, Colour.FromRgb(0, 0, 255));
graphics.FillText(60, 70, "Invoice",
    new Font(FontFamily.ResolveFontFamily(FontFamily.StandardFontFamilies.Helvetica), 20),
    Colours.White);
// ... continue drawing every single element manually

IronPDF使用HTML - 這是通用的文件格式：

// IronPDF: Declarative HTML for document creation
var html = "<h1>Invoice</h1><p>Customer: Acme Corp</p>";
var pdf = renderer.RenderHtmlAsPdf(html);

IronPDF與VectSharp：功能比較

了解結構差異有助於技術決策者評估遷移投資：

功能VectSharpIronPDF
主要用途向量圖形文件建立
PDF輸出是是
HTML支持否是
授權LGPL-3.0-only商業
開源是部分（商業功能）
最佳用於科學可視化普通PDF文件
自定義化受限於圖形廣泛的，文件相關的
HTML 到 PDF否完整的Chromium
URL至PDF否是
CSS 支援否完整支持 CSS3
JavaScript否完整的ES2024
自動佈局否是
自動分頁否是
文字換行手動自動
合併PDF否是
分割PDF否是
密碼保護否是
數位簽名否是
學習曲線高（座標）低（HTML/CSS）
程式碼冗長性非常高低

快速開始：從VectSharp到IronPDF的遷移

可以立即透過這些基本步驟開始遷移。

步驟 1：替換 NuGet 套件

移除所有VectSharp包：

# Remove VectSharp packages (PDF first, then core)
dotnet remove package VectSharp.PDF
dotnet remove package VectSharp
SHELL

安裝 IronPDF：

# Install IronPDF
dotnet add package IronPdf
SHELL

步驟 2：更新命名空間

用IronPDF命名空間替換VectSharp命名空間：

// Before (VectSharp)
using VectSharp;
using VectSharp.PDF;

// After (IronPDF)
using IronPdf;

步驟 3：初始化授權

在應用啓動時新增授權初始化：

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

程式碼遷移範例

將HTML轉換為PDF

VectSharp不支持HTML到PDF的轉換。 這個基本功能差異推動了許多遷移決定。

VectSharp方法：

// NuGet: Install-Package VectSharp.PDF
using VectSharp;
using VectSharp.PDF;
using VectSharp.SVG;
using System.IO;

class Program
{
    static void Main()
    {
        // VectSharp doesn't directly support HTML to PDF
        // It requires manual creation of graphics objects
        Document doc = new Document();
        Page page = new Page(595, 842); // A4 size
        Graphics graphics = page.Graphics;
        
        graphics.FillText(100, 100, "Hello from VectSharp",
            new Font(FontFamily.ResolveFontFamily(FontFamily.StandardFontFamilies.Helvetica), 24),
            Colours.Black);
        
        doc.Pages.Add(page);
        doc.SaveAsPDF("output.pdf");
    }
}

IronPDF 方法：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF</h1><p>This is HTML content.</p>");
        pdf.SaveAs("output.pdf");
    }
}

VectSharp要求建立Document, Graphics物件，然後用精確的坐標和字體物件手動定位文字。 IronPDF直接渲染HTML，提供完整的CSS樣式支持。

如需進階 HTML 到 PDF 的場景，請參見 HTML 到 PDF 轉換指南。

建立多頁文件

多頁文件揭示了這些.NET PDF庫之間的架構差異。

VectSharp方法：

// NuGet: Install-Package VectSharp.PDF
using VectSharp;
using VectSharp.PDF;
using System;

class Program
{
    static void Main()
    {
        Document doc = new Document();
        
        FontFamily helvetica =
            FontFamily.ResolveFontFamily(FontFamily.StandardFontFamilies.Helvetica);
        Font titleFont = new Font(helvetica, 24);
        Font bodyFont = new Font(helvetica, 14);

        // Page 1
        Page page1 = new Page(595, 842);
        Graphics g1 = page1.Graphics;
        g1.FillText(50, 50, "Page 1", titleFont, Colours.Black);
        g1.FillText(50, 100, "First page content", bodyFont, Colours.Black);
        doc.Pages.Add(page1);
        
        // Page 2
        Page page2 = new Page(595, 842);
        Graphics g2 = page2.Graphics;
        g2.FillText(50, 50, "Page 2", titleFont, Colours.Black);
        g2.FillText(50, 100, "Second page content", bodyFont, Colours.Black);
        doc.Pages.Add(page2);
        
        doc.SaveAsPDF("multipage.pdf");
    }
}

IronPDF 方法：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        string html = @"
            <h1>Page 1</h1>
            <p>First page content</p>
            <div style='page-break-after: always;'></div>
            <h1>Page 2</h1>
            <p>Second page content</p>
        ";
        
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("multipage.pdf");
    }
}

VectSharp需要建立單獨的Graphics上下文，並手動定位每個頁面上的每個文字元素，使用座標和字體物件。 IronPDF使用單個HTML字串，並用CSS page-break-after: always自動建立多頁文件。

繪製形狀和文字

圖形能力展示了VectSharp的優勢，但同時也展示了網頁標準如何用更少的程式碼提供等效功能。

VectSharp方法：

// NuGet: Install-Package VectSharp.PDF
using VectSharp;
using VectSharp.PDF;
using System;

class Program
{
    static void Main()
    {
        Document doc = new Document();
        Page page = new Page(595, 842);
        Graphics graphics = page.Graphics;
        
        // Draw rectangle
        graphics.FillRectangle(50, 50, 200, 100, Colour.FromRgb(0, 0, 255));
        
        // Draw circle
        GraphicsPath circle = new GraphicsPath();
        circle.Arc(400, 100, 50, 0, 2 * Math.PI);
        graphics.FillPath(circle, Colour.FromRgb(255, 0, 0));
        
        // Add text - FillText requires a colour parameter
        graphics.FillText(50, 200, "VectSharp Graphics",
            new Font(FontFamily.ResolveFontFamily(FontFamily.StandardFontFamilies.Helvetica), 20),
            Colours.Black);
        
        doc.Pages.Add(page);
        doc.SaveAsPDF("shapes.pdf");
    }
}

IronPDF 方法：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        string html = @"
            <div style='width: 200px; height: 100px; background-color: blue; margin: 50px;'></div>
            <div style='width: 100px; height: 100px; background-color: red; 
                        border-radius: 50%; margin-left: 350px; margin-top: -50px;'></div>
            <h2 style='margin-left: 50px;'>IronPDF Graphics</h2>
        ";
        
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("shapes.pdf");
    }
}

VectSharp需要建立Colour.FromRgb()管理顏色。 IronPDF使用熟悉的CSS屬性：background-color, border-radius: 50%用於圓形，以及標準的邊距。

從VectSharp API到IronPDF的映射參考

此映射透過展示直接的 API 等價加速遷移：

VectSharpIronPDF
DocumentChromePdfRenderer
Page自動
GraphicsHTML/CSS
graphics.FillRectangle()CSS background-color on <div>
graphics.StrokeRectangle()CSS border on <div>
graphics.FillText()HTML文字元素
graphics.StrokePath()SVG或CSS邊框
GraphicsPathSVG <path> 元素
Colour.FromRgb()CSS顏色值
Font / FontFamilyCSS font-family
doc.SaveAsPDF()pdf.SaveAs()
手動頁面尺寸設置RenderingOptions.PaperSize

遷移策略

策略1：將繪圖程式碼轉換為HTML/CSS

使用HTML元素替換基於座標的繪圖：

// VectSharp
graphics.FillRectangle(100, 50, 300, 80, Colour.FromRgb(0, 102, 204));
graphics.FillText(110, 80, "Header", font, Colours.White);

//IronPDFHTML equivalent
<div style="
    position: absolute;
    left: 100px;
    top: 50px;
    width: 300px;
    height: 80px;
    background: rgb(0, 102, 204);
    color: white;
    padding: 10px;
">Header</div>

策略2：使用SVG作為向量圖形

對於複雜的形狀，在您的HTML中使用內嵌SVG：

// VectSharp path
GraphicsPath path = new GraphicsPath();
path.MoveTo(100, 100);
path.LineTo(200, 50);
path.LineTo(300, 100);
path.Close();
graphics.FillPath(path, Colours.Blue);

//IronPDFSVG equivalent
<svg><polygon points="100,100 200,50 300,100" fill="blue"/></svg>

策略3：使用JavaScript圖表函式庫

對於科學可視化 - VectSharp的專長 - IronPDF可以利用強大的JavaScript庫，例如Chart.js、D3.js或Plotly：

var html = @"
<script src='https://cdn.plot.ly/plotly-latest.min.js'></script>
<div id='chart'></div>
<script>
    Plotly.newPlot('chart', [{
        x: [1, 2, 3, 4],
        y: [10, 15, 13, 17],
        type: 'scatter'
    }]);
</script>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
var pdf = renderer.RenderHtmlAsPdf(html);

常見遷移問題及解決方案

問題1：座標系統差異

VectSharp 使用從左上角開始的點，需手動定位。

解決方案： 使用CSS定位：

.element {
    position: absolute;
    top: 50px;
    left: 100px;
}
CSS

問題2：字體物件

VectSharp 以程式方式建立FontFamily物件。

解決方案： 使用CSS字體族：

<style>
    body { font-family: Arial, sans-serif; font-size: 12pt; }
</style>
HTML

問題3：顏色處理

VectSharp 使用Colour.FromRgb()方法調用。

解決方案： 使用CSS顏色：

.header { color: rgb(0, 102, 204); background-color: #f0f0f0; }
CSS

問題4：圖形路徑

VectSharp 使用複雜的GraphicsPath API及MoveTo, LineTo, Arc方法。

解決方案： 使用SVG作為向量圖形：

<svg>
    <path d="M 100 100 L 200 50 L 300 100 Z" fill="blue"/>
</svg>
HTML

VectSharp遷移檢查清單

遷移前任務

審核您的程式碼庫以識別所有VectSharp使用情況：

grep -r "using VectSharp" --include="*.cs" .
grep -r "Graphics\|FillRectangle\|FillText" --include="*.cs" .
SHELL

記錄頁面尺寸（new Page(595, 842)模式）。 註明使用Colour.FromRgb()的顏色方案。 確定字體設置。 使用GraphicsPath識別複雜的向量圖進行SVG轉換。

程式碼更新任務

  1. 移除VectSharp NuGet包
  2. 安裝IronPDFNuGet 套件
  3. 將using語句從IronPdf
  4. 將background-color的CSS框
  5. 將FillText調用轉換為帶有CSS樣式的HTML文字元素
  6. 將GraphicsPath操作轉換為SVG <path>元素
  7. 用RenderingOptions.PaperSize取代手動頁面管理
  8. 在啟動時新增授權初始化

遷移後測試

遷移後，驗證以下方面：

  • 比較VectSharp與IronPDF版本之間的視覺輸出
  • 驗證顏色使用Colour.FromRgb()值的CSS等效項以匹配
  • 檢查從基於座標的放置轉換的元素的定位準確性
  • 測試多頁文件的分頁
  • 驗證通過SVG正確渲染的向量圖形

遷移到IronPDF的關鍵好處

從VectSharp轉到IronPDF為文件生成提供了多個優勢：

基於HTML的內容： 網頁開發者可以利用現有的HTML和CSS技能。 不需要學習基於座標的繪圖API。

自動佈局： 文字換行、分頁和流佈局自動進行。 不需要手算元素位置。

現代CSS支持： 完整的CSS3包括Flexbox和網格佈局。 響應式設計直接轉化為PDF。

JavaScript執行： 使用Chart.js、D3.js或Plotly的互動式圖表可以正確渲染。 動態內容如預期運行。

URL轉PDF： 捕捉任何網頁為PDF - 這是VectSharp無法實現的功能。

PDF操作： 合併、分割、新增水印、密碼保護和數位簽名都是內建功能。

更低的程式碼冗長性： HTML/CSS是陳述性的且易讀。 相同的文件需要比VectSharp的命令式繪圖方法更少的程式碼。

主動開發： IronPDF的定期更新保證與當前和未來.NET版本的相容性。

請注意: VectSharp是其各自所有者的註冊商標。 本網站不與VectSharp有任何聯繫、未被其認可或贊助。所有產品名稱、標誌和品牌屬於其各自所有者。 比較僅供參考，反映撰寫時公開可用的資訊。
Curtis Chau
Curtis Chau
技術作家

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

閱讀更多

相關文章