在现代 .NET 应用程序中，创建和管理 PDF 文件是一项常见需求——无论是生成报告、发票还是数字记录。 开发人员通常为此任务转向第三方PDF库，而.NET生态系统中最流行的两个选项是IronPDF和iText（iText的继承者）。
每个库都为不同的用例提供了强大的工具集。 但哪一个最适合使用C#从[字节数组](https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2013/dd831853(v=vs.120)生成PDF？ 本文通过比较、代码示例和见解来帮助 .NET 开发人员做出正确的选择。
无论您是构建企业级应用程序还是小型内部工具，选择正确的 PDF 库都可以为您节省开发时间并确保强大的输出。 让我们探索每个库提供的功能。
C# 的 PDF 库允许开发人员以编程方式生成、操作和读取 PDF 文件。 它们适用于广泛的用例，例如：
它们还在数据可移植性和符合 PDF/A 标准进行存档或可访问性要求方面发挥着关键作用。
在可用的.NET PDF库中，iText和IronPDF作为领先的解决方案出现——各有其独特优势：
选择这两个库不仅仅是偏好的问题——它影响生产力、维护、性能，甚至是法律许可证合规性。 需要快速周转、频繁格式更改或从 HTML 模板到 PDF 渲染的项目可从快速开发中受益，而企业级应用程序可能会优先考虑标准合规性和长期可维护性。
iText是iText的官方继承者，提供了完全重新设计的架构。 它是一个功能强大、可扩展的库，适合在合规要求严苛的行业中创建、编辑和验证 PDF，如法律、金融和政府。 iText套件包含对PDF/A、PDF/UA、数字签名、修订和表单创建的支持。
尽管它仍然是 AGPL 许可证下的开源软件，但对于专有项目提供商业许可证。
下载iText的核心包用于PDF生成：
您也可以通过解决方案屏幕的包管理器安装iText。 为此，您首先需要进入工具下拉菜单，然后找到"NuGet 包管理器 > 管理解决方案的 NuGet 包"。
然后，只需搜索iText，并点击"安装"。
using System.IO;
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.GeneratePdfWithIText7();
// Save the PDF to a file
File.WriteAllBytes("output.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] GeneratePdfWithIText7()
{
using (var ms = new MemoryStream())
{
var writer = new PdfWriter(ms);
var pdf = new iText.Kernel.Pdf.PdfDocument(writer);
var doc = new Document(pdf);
doc.Add(new Paragraph("Hello from iText 7 for .NET!"));
doc.Close(); // Always close the document to finalize content
return ms.ToArray();
}
}
}Imports System.IO
Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.Layout.Element
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.GeneratePdfWithIText7()
' Save the PDF to a file
File.WriteAllBytes("output.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function GeneratePdfWithIText7() As Byte()
Using ms = New MemoryStream()
Dim writer = New PdfWriter(ms)
Dim pdf = New iText.Kernel.Pdf.PdfDocument(writer)
Dim doc = New Document(pdf)
doc.Add(New Paragraph("Hello from iText 7 for .NET!"))
doc.Close() ' Always close the document to finalize content
Return ms.ToArray()
End Using
End Function
End Class输出 PDF 文件
解释
MemoryStream。PdfDocument管理PDF的内部结构。Document用于添加高级内容（文本、图像、表格）。doc.Close()后，PDF内容已完全写入并准备返回为字节数组。此示例展示了iText的更模块化和可读的API，与iText相比。 然而，除非包含pdfhtml，否则仍然不支持本地渲染HTML/CSS，且其许可是单独的。
优点：
全面的 PDF 控制
iText为PDF元素提供了完整的控制，如表格、表单和数字签名。 这使得它非常适合对需要特定 PDF 标准（如 PDF/A 或 PDF/UA）的合规要求苛刻的应用程序。
模块化和可扩展
iText是模块化的，意味着您可以仅安装所需的特定模块（例如用于HTML到PDF转换的pdfhtml）。 如果您不使用所有功能，这可以实现更轻量级的实现。
支持复杂的 PDF 标准
iText支持ISO标准，如PDF/A（归档）、PDF/UA（可访问性）和PDF/X（打印），这使其适用于合规性至关重要的专业和法律环境。
丰富的文档和支持
iText拥有完善的文档和一个庞大的社区。 公司还提供专业支持，确保开发人员在需要时可以获得帮助。
免费版本可用（AGPL）
开发人员可以免费使用iText在AGPL许可下，这对于开源项目或个人使用是理想的。
缺点：
商业用途的 AGPL 许可证
虽然iText提供免费版本，但商业用户必须符合AGPL许可，即需要公布任何使用iText的软件的源代码，或支付商业许可费用。
学习曲线陡峭
iText的API更复杂和功能丰富，这相比于像IronPDF这样的简单库，会导致一个更陡峭的学习曲线。 开发人员需要熟悉其低级文档结构和模块化架构。
简单任务的复杂处理 对于基本的PDF任务，如简单的文档创建或基本的HTML到PDF转换，iText可能感觉繁琐，特别是相比于IronPDF这类简化流程的库。
HTML 到 PDF 需要外部模块
在iText中，HTML到PDF的转换仅通过额外的pdfhtml模块可用，这需要单独安装，可能无法像IronPDF那样无缝处理现代Web内容。
IronPDF 是一个高级 .NET 库，旨在简化 PDF 文档生成，专注于开发人员的生产力。 它尤其适用于渲染 HTML 内容和样式，使其非常适合现代 Web 到 PDF 的工作流。
IronPDF 也可以通过 NuGet 安装，只需在 NuGet 包管理器控制台中运行以下命令即可：
或者，您可以通过解决方案的 NuGet 包管理器安装它。 为此，请导航到"工具 > NuGet 包管理器 > 管理解决方案的 NuGet 包"。
然后，搜索 IronPDF 并单击"安装"。
安装后，您可以在几秒钟内开始将完整的 HTML 页面渲染到 PDF——不需要额外的模块。 它支持现代 CSS、JavaScript，甚至是交互式网页内容，无需额外配置。
using IronPdf;
using System.IO;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.GeneratePdfWithIronPdf();
// Save the PDF to a file
File.WriteAllBytes("output.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] GeneratePdfWithIronPdf()
{
var renderer = new ChromePdfRenderer();
var pdfDoc = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
return pdfDoc.BinaryData;
}
}Imports IronPdf
Imports System.IO
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.GeneratePdfWithIronPdf()
' Save the PDF to a file
File.WriteAllBytes("output.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function GeneratePdfWithIronPdf() As Byte()
Dim renderer = New ChromePdfRenderer()
Dim pdfDoc = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>")
Return pdfDoc.BinaryData
End Function
End Class输出 PDF 文件
解释
using IronPdf语句导入IronPDF库以访问所有PDF相关类。var renderer = new ChromePdfRenderer()创建一个由无头Chromium引擎驱动的新HTML到PDF渲染器。renderer.RenderHtmlAsPdf(...)将给定的HTML字符串转换为PDF文档。 您还可以传入文件路径或 URL。pdfDoc.BinaryData返回最终PDF为字节数组，准备保存、流媒体传输或数据库存储。优点：
轻松实现 HTML 到 PDF 渲染
将 HTML、CSS 和 JavaScript 内容直接渲染为 PDF，具有完整的样式，包括 Bootstrap 和自定义字体——无需复杂的布局代码或额外模块。
快速开始和直观的 API
在几行代码中创建完全样式化的 PDF 文件，语法简洁，并完全兼容 .NET Core 和 .NET Framework。
对 Web 技术的全面支持
IronPDF 支持 JavaScript、现代 CSS、SVG 和媒体查询——大多数库在这方面存在困难，除非它们使用像 Chromium 这样的无头浏览器（IronPDF 在内部是这样做的）。
内置图像和资产处理
轻松包含图像、本地文件，甚至可以从远程 URL 中提取资产，无需额外配置。
永久许可证和无 AGPL
与iText不同，IronPDF提供灵活的商业许可，无需遵循开源AGPL义务的限制。
非常适合 MVC 和 Razor 视图
无缝转换 ASP.NET 应用程序中的 .cshtml Razor 视图为可打印的 PDF。
缺点：
商业用途需授权
虽然有免费试用版，但 IronPDF 不是开源的。 预算紧张的项目可能需要评估许可成本。
初始包大小较大
由于它捆绑了一个无头 Chromium 引擎，NuGet 包比一些替代方案更重。
本节中的以下代码示例演示了这些库的使用，我们将在相同任务中比较IronPDF和iText。 两个库将在相同的场景下进行测试：从 URL 生成 PDF、将图像渲染为 PDF，以及将样式化的 HTML 转换为 PDF，同时使用字节数组来处理我们的 PDF 内容。 这将使开发人员能够评估每个库如何处理这些常见用例。
using IronPdf;
using System.IO;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.GeneratePdfFromUrlWithIronPdf();
// Save the PDF to a file
File.WriteAllBytes("ironpdf-from-url.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] GeneratePdfFromUrlWithIronPdf()
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitForJavaScript(5000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
var pdf = renderer.RenderUrlAsPdf("https://www.apple.com");
return pdf.BinaryData;
}
}Imports IronPdf
Imports System.IO
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.GeneratePdfFromUrlWithIronPdf()
' Save the PDF to a file
File.WriteAllBytes("ironpdf-from-url.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function GeneratePdfFromUrlWithIronPdf() As Byte()
Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitForJavaScript(5000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
Dim pdf = renderer.RenderUrlAsPdf("https://www.apple.com")
Return pdf.BinaryData
End Function
End Class输出 PDF
IronPDF 使用无头 Chromium 引擎实现网页的 像素级渲染，支持完整的 JavaScript 和 CSS。
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using System.Net.Http;
using System.Threading.Tasks;
using iText.Html2pdf;
using System.IO;
class Program
{
static async Task Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = await pdfGenerator.GeneratePdfFromUrlWithIText7Async();
// Save the PDF to a file
File.WriteAllBytes("itext7-from-url.pdf", pdfBytes);
}
}
class PdfGenerator
{
public async Task<byte[]> GeneratePdfFromUrlWithIText7Async()
{
using var httpClient = new HttpClient();
string html = await httpClient.GetStringAsync("https://www.apple.com");
using var stream = new MemoryStream();
HtmlConverter.ConvertToPdf(html, stream);
return stream.ToArray();
}
}Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.Layout.Element
Imports System.Net.Http
Imports System.Threading.Tasks
Imports iText.Html2pdf
Imports System.IO
Friend Class Program
Shared Async Function Main(ByVal args() As String) As Task
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = Await pdfGenerator.GeneratePdfFromUrlWithIText7Async()
' Save the PDF to a file
File.WriteAllBytes("itext7-from-url.pdf", pdfBytes)
End Function
End Class
Friend Class PdfGenerator
Public Async Function GeneratePdfFromUrlWithIText7Async() As Task(Of Byte())
Dim httpClient As New HttpClient()
Dim html As String = Await httpClient.GetStringAsync("https://www.apple.com")
Dim stream = New MemoryStream()
HtmlConverter.ConvertToPdf(html, stream)
Return stream.ToArray()
End Function
End Class输出
iText使用HttpClient获取原始HTML并通过HtmlConverter进行渲染，但不支持JavaScript执行（iText官方文档确认，推荐使用Selenium等浏览器自动化进行JavaScript预处理），且CSS样式有限。 虽然iText在版本7.1.15（2021年）中添加了部分flexbox支持，但许多CSS3属性仍不受支持，特别是对于复杂的现代布局。
using IronPdf;
using System.IO;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();
// Save the PDF to a file
File.WriteAllBytes("ironpdf-with-image.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] CreatePdfWithImage()
{
var pdf = ImageToPdfConverter.ImageToPdf("example.png");
return pdf.BinaryData;
}
}Imports IronPdf
Imports System.IO
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.CreatePdfWithImage()
' Save the PDF to a file
File.WriteAllBytes("ironpdf-with-image.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function CreatePdfWithImage() As Byte()
Dim pdf = ImageToPdfConverter.ImageToPdf("example.png")
Return pdf.BinaryData
End Function
End Class输出
using IronPDF 的 ImageToPdfConverter 工具轻松将图像生成为 PDF。 通过这种方式，您可以轻松地从图像（如 PNG 文件或 JPG）创建 PDF 文件。
using iText.Kernel.Pdf;
using iText.Layout;
using iText.IO.Image;
using iText.Layout.Element;
using System.IO;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();
// Save the PDF to a file
File.WriteAllBytes("iText-with-image.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] CreatePdfWithImage()
{
using var ms = new MemoryStream();
using var writer = new PdfWriter(ms);
using var pdfDoc = new iText.Kernel.Pdf.PdfDocument(writer);
var document = new Document(pdfDoc);
var img = new Image(ImageDataFactory.Create("https://itextpdf.com/sites/default/files/2018-11/iText%207%20Product%20software%20-%20webimages_509x339px_V2_iText%207%20Core.png"));
document.Add(img);
document.Close();
return ms.ToArray();
}
}Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.IO.Image
Imports iText.Layout.Element
Imports System.IO
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.CreatePdfWithImage()
' Save the PDF to a file
File.WriteAllBytes("iText-with-image.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function CreatePdfWithImage() As Byte()
Dim ms = New MemoryStream()
Dim writer = New PdfWriter(ms)
Dim pdfDoc = New iText.Kernel.Pdf.PdfDocument(writer)
Dim document As New Document(pdfDoc)
Dim img = New Image(ImageDataFactory.Create("https://itextpdf.com/sites/default/files/2018-11/iText%207%20Product%20software%20-%20webimages_509x339px_V2_iText%207%20Core.png"))
document.Add(img)
document.Close()
Return ms.ToArray()
End Function
End Class输出
using ImageDataFactory 手动创建文档布局并显式插入图像。
using IronPdf;
using System.IO;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.CreateStyledPdf();
// Save the PDF to a file
File.WriteAllBytes("ironpdf-styled-html.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] CreateStyledPdf()
{
string html = @"
<html>
<head>
<style>
body {
background-color: #f0f0f0;
margin: 20px;
padding: 20px;
border-radius: 5px;
box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
}
h1 {
color: navy;
font-size: 32px;
text-align: center;
}
p {
font-size: 16px;
font-weight: bold;
}
</style>
</head>
<body>
<h1>Welcome to IronPDF</h1>
<p>This is a simple PDF document generated using IronPDF.</p>
</body>
</html>";
var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);
return pdf.BinaryData;
}
}Imports IronPdf
Imports System.IO
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.CreateStyledPdf()
' Save the PDF to a file
File.WriteAllBytes("ironpdf-styled-html.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function CreateStyledPdf() As Byte()
Dim html As String = "
<html>
<head>
<style>
body {
background-color: #f0f0f0;
margin: 20px;
padding: 20px;
border-radius: 5px;
box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
}
h1 {
color: navy;
font-size: 32px;
text-align: center;
}
p {
font-size: 16px;
font-weight: bold;
}
</style>
</head>
<body>
<h1>Welcome to IronPDF</h1>
<p>This is a simple PDF document generated using IronPDF.</p>
</body>
</html>"
Dim pdf = (New ChromePdfRenderer()).RenderHtmlAsPdf(html)
Return pdf.BinaryData
End Function
End Class输出
IronPDF 借助其 Chromium 引擎完全支持标签或外部样式表中的 CSS。
using iText.Kernel.Pdf;
using iText.Html2pdf;
using System.IO;
class Program
{
static void Main(string[] args)
{
var pdfGenerator = new PdfGenerator();
byte[] pdfBytes = pdfGenerator.CreateStyledPdf();
// Save the new document to the specified file location
File.WriteAllBytes("iText-styled-html.pdf", pdfBytes);
}
}
class PdfGenerator
{
public byte[] CreateStyledPdf()
{
string html = @"
<html>
<head>
<style>
body {
background-color: #f0f0f0;
margin: 20px;
padding: 20px;
border-radius: 5px;
box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
}
h1 {
color: navy;
font-size: 32px;
text-align: center;
}
p {
font-size: 16px;
font-weight: bold;
}
</style>
</head>
<body>
<h1>Welcome to iText 7</h1>
<p>This is a simple PDF document generated using iText 7 and pdfHTML.</p>
</body>
</html>";
using var ms = new MemoryStream();
ConverterProperties properties = new ConverterProperties();
HtmlConverter.ConvertToPdf(new MemoryStream(System.Text.Encoding.UTF8.GetBytes(html)), ms, properties);
return ms.ToArray();
}
}Imports iText.Kernel.Pdf
Imports iText.Html2pdf
Imports System.IO
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim pdfGenerator As New PdfGenerator()
Dim pdfBytes() As Byte = pdfGenerator.CreateStyledPdf()
' Save the new document to the specified file location
File.WriteAllBytes("iText-styled-html.pdf", pdfBytes)
End Sub
End Class
Friend Class PdfGenerator
Public Function CreateStyledPdf() As Byte()
Dim html As String = "
<html>
<head>
<style>
body {
background-color: #f0f0f0;
margin: 20px;
padding: 20px;
border-radius: 5px;
box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
}
h1 {
color: navy;
font-size: 32px;
text-align: center;
}
p {
font-size: 16px;
font-weight: bold;
}
</style>
</head>
<body>
<h1>Welcome to iText 7</h1>
<p>This is a simple PDF document generated using iText 7 and pdfHTML.</p>
</body>
</html>"
Dim ms = New MemoryStream()
Dim properties As New ConverterProperties()
HtmlConverter.ConvertToPdf(New MemoryStream(System.Text.Encoding.UTF8.GetBytes(html)), ms, properties)
Return ms.ToArray()
End Function
End Class输出
需要安装付费插件 pdfHTML 才能处理 HTML 转换任务。
| 功能 | IronPDF | iText（带pdfHTML） |
|---|---|---|
| 将 URL 渲染为 PDF | 全 Chromium 渲染 | 获取 HTML，原生无 JS 支持 |
| 添加图像 | 通过 HTML 或其专用图像印章工具嵌入 | 手动图像生成器 |
| 渲染样式化 HTML | 完全支持 CSS | 仅通过 pdfHTML 支持 CSS |
| 返回字节数组 | 是 | 是 |
| 设置复杂度 | 简单 | 中等（手动排版） |
| 输出质量 | 像素完美 | 不错，但略显呆板 |
选择IronPDF还是iText取决于您的项目需求——但在开发者体验、易用性和现代渲染准确性方面，IronPDF显然更突出。
如果您需处理动态 HTML 内容、Web 渲染，或需要创建具有完整 JavaScript 和 CSS 支持的 PDF 文件 从 URL，IronPDF 的 Chromium 引擎提供了无与伦比的忠实度。 其直观的 API 和快速设置使其非常适合快速开发和现实世界的生产使用——特别是在使用字节数组、文件流或基于 Web 的 PDF 生成时。
另一方面，iText是一个功能强大且受尊重的库，采用更传统的基于布局的方法。 它提供了对文档结构的良好控制，非常适合需要精细操作的开发人员，但学习曲线较陡峭，缺乏现代 HTML 渲染功能。
结论如下：
准备好开始使用 IronPDF了吗？ 下载免费试用版，看看在 C# 中创建专业的、基于字节数组的 PDF 是多么简单，仅需几行代码即可完成。
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
当您需要PDF看起来像HTML时，速度快。
