IRONSOFTWAREHOME
IRONSUITE所有10的价格为2
联系销售
按公司
加入我们的专家网络
视频

如何用 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.SVG 和 VectSharp.Raster。 它不是为文档生成而设计的——它是一个绘图库，其 VectSharp.PDF 包增加了 SaveAsPDF 扩展方法于 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
C#

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）
代码准确性极高low

快速入门：VectSharp 到IronPDF的迁移

迁移工作可以通过以下基本步骤立即开始。

步骤 1：替换 NuGet 软件包

删除所有VectSharp软件包：

# RemoveVectSharppackages (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()
    {
        //VectSharpdoesn'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");
    }
}
C#

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 需要创建一个 Page 和 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");
    }
}
C#

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 需要创建单独的 Page 对象、单独的 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");
    }
}
C#

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 需要创建 GraphicsPath 对象，调用具有精确数学参数的 Arc()，并通过 Colour.FromRgb() 管理颜色。IronPDF使用熟悉的 CSS 属性：border-radius: 50% 用于圆形，以及标准的边距。

VectSharpAPI 到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> element
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：

//VectSharppath
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;
}
Text

问题 2：字体对象

VectSharp 以编程方式创建 Font 和 FontFamily 对象。

**解决方案：**使用 CSS 字体-family：

<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; }
Text

第 4 期：图形路径

VectSharp 使用复杂的 GraphicsPath API，其中包含 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.删除VectSharpNuGet 软件包 2. 安装IronPDF NuGet包 3. 更新使用声明从 VectSharp 到 IronPdf 4. 将 FillRectangle 调用转换为带有 background-color 的 CSS 框 5. 将 FillText 调用转换为带有 CSS 样式的 HTML 文本元素 6. 将 GraphicsPath 操作转换为 SVG <path> 元素 7. 用 RenderingOptions.PaperSize 替换手动页面管理 8.在启动时添加许可证初始化

迁移后测试

迁移后，验证这些方面：

  • 比较VectSharp和IronPDF版本的可视化输出结果
  • 使用 CSS 等效的 Colour.FromRgb() 值验证颜色匹配
  • 检查从基于坐标的放置转换而来的元素的定位精度
  • 测试多页文档的分页符
  • 通过 SVG 验证矢量图形的正确呈现

迁移到IronPDF的主要优势

从VectSharp迁移到IronPDF为文档生成提供了多项优势：

基于 HTML 的内容： Web 开发人员可以利用现有的 HTML 和 CSS 技能。 无需学习基于坐标的绘图 API。

**自动布局：**文本换行、分页和流式布局自动完成。 无需手动计算元素位置。

**现代 CSS 支持：**完全支持 CSS3，包括 Flexbox 和 Grid 布局。 响应式设计可直接翻译成 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 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

相关文章

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户