IronPDF 与 iTextSharp MVC 在 C# 中查看 PDF 文件的对比

安装iTextSharp

要在 ASP.NET Core MVC 项目中添加 iTextSharp，请安装 NuGet 软件包：

Install-Package iTextSharp

使用iTextSharp的基本实现

下面是一个完整的示例，展示了如何在 ASP.NET MVC 项目中使用iTextSharp的 XMLWorkerHelper 类将 MVC 视图转换为 PDF：

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // First step: Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Now.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";
        // Create PDF document using iTextSharp
        using (var stream = new MemoryStream())
        {
            var document = new Document(PageSize.A4);
            PdfWriter writer = PdfWriter.GetInstance(document, stream);
            document.Open();
            using (var srHtml = new StringReader(invoiceHtml))
            {
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
            }
            document.Close();
            // Return the PDF file with binary data
            return new FileContentResult(stream.ToArray(), "application/pdf")
            {
                FileDownloadName = "invoice.pdf"
            };
        }
    }
}

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // First step: Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Now.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";
        // Create PDF document using iTextSharp
        using (var stream = new MemoryStream())
        {
            var document = new Document(PageSize.A4);
            PdfWriter writer = PdfWriter.GetInstance(document, stream);
            document.Open();
            using (var srHtml = new StringReader(invoiceHtml))
            {
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
            }
            document.Close();
            // Return the PDF file with binary data
            return new FileContentResult(stream.ToArray(), "application/pdf")
            {
                FileDownloadName = "invoice.pdf"
            };
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

本完整代码可从 Visual Studio 项目中的 HTML 内容创建基本的 PDF 文档。 XMLWorkerHelper 类使用对象模型处理 HTML 字符串并将元素添加到 PDF 文档中。 PdfWriter 处理实际的 PDF 生成过程，而 Document 则管理页面结构。 请注意，本示例使用了推荐的较新方法，以获得更好的效果。

输出

了解iTextSharp的限制

XMLWorkerHelper 类支持基本 HTML 标记和内联 CSS。 现代 CSS3 属性、flexbox 布局和网格系统无法呈现。 依赖 JavaScript 的内容将完全消失。 忽略渐变、阴影和变换等复杂样式。 即使是标准的 Bootstrap 类也无法应用，这将使您精心设计的视图看起来平淡无奇、不专业。 许多开发人员已经在 Stack Overflow 上报告了这些限制，导致他们在尝试使用iTextSharp将 MVC 视图转换为 PDF 时感到沮丧。

也许更令人担忧的是iTextSharp的许可模式。 该库使用 AGPL 许可证，如果您使用免费版本，则需要将整个应用程序开源。 商业许可证的起价为每年几千美元，这对许多企业来说都很昂贵。 这种许可限制促使许多开发人员寻求更符合商业开发需求的替代方案。 正如 Microsoft 的 .NET 文档中所讨论的，选择具有适当许可证的库对于商业项目至关重要。

安装 IronPDF。

只需一个简单的 NuGet 命令即可将 IronPDF 添加到您的项目中：

Install-Package IronPdf

使用 IronPdf 实现现代化

让我们在您的 ASP.NET MVC Web 应用程序中使用 IronPDF for .NET 创建具有增强样式的相同发票：

using IronPdf;
public class HomeController : Controller
{
    // Action method to display the index view
    public ActionResult Index()
    {
        return View();
    }
    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML file content with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";
        // Create PDF with Chrome rendering engine
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);
        // Set content disposition for download in browser
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");
        // Return the PDF file with binary data to the user
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;
public class HomeController : Controller
{
    // Action method to display the index view
    public ActionResult Index()
    {
        return View();
    }
    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML file content with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";
        // Create PDF with Chrome rendering engine
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);
        // Set content disposition for download in browser
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");
        // Return the PDF file with binary data to the user
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

本实现利用 IronPDF 的 ChromePdfRenderer 来转换 HTML，使其与在 Chrome 浏览器中显示的完全一致。 渐变背景、现代字体和精致的风格都能完美呈现。 呈现器可处理iTextSharp无法处理的复杂 CSS 属性，包括柔性框、网格布局、变换和动画（呈现为静态帧）。 RenderHtmlAsPdf 方法使在 MVC 中将 HTML 转换为 PDF 变得异常简单。

输出

。

开始免费试用，体验 IronPDF 的 Chrome 渲染引擎带来的现代 PDF 生成功能。

功能对比

许可注意事项

这些库之间的许可差异会对商业开发产生重大影响。iTextSharp的 AGPL 许可证产生了许多企业无法接受的法律义务。 使用免费版本需要开源整个应用程序，包括专有的业务逻辑。 这一限制使得iTextSharp不适合大多数商业项目，除非您购买昂贵的商业许可证。

IronPDF 提供直接的商业许可，单个开发人员的起价为 749 美元。 许可证包括一年的更新和支持，但没有义务将您的应用程序开源。 这种透明的定价模式符合典型的软件开发预算，使各种规模的企业在用 C# 将 MVC 视图转换为 PDF 时都能获得专业的 PDF 生成服务。

输出质量分析

在比较输出结果时，渲染质量的差异会立即显现出来。iTextSharp生成的基本 PDF 与 2000 年代早期的文档相似。 表格缺乏适当的样式，字体默认为系统标准，现代设计元素完全消失。 翻译出来的 PDF 看起来不专业，也无法与您的应用程序品牌相匹配。

IronPDF 可生成与您的网页设计完全匹配的像素级完美 PDF。 渐变效果要流畅，自定义字体要正确显示，复杂布局要保持结构完整。 Chromium 引擎可确保您的 PDF 文件看起来与网页视图完全一致，在所有生成的文件中保持您的品牌形象和专业外观。

页眉和页脚

添加具有动态内容的专业页眉和页脚：

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

IRON VB CONVERTER ERROR developers@ironsoftware.com

这种配置可为每个页面添加一致的品牌。 占位符{page}和{total-pages}会自动填充正确的值，确保整个文档的分页准确无误。

安全性和加密

使用 IronPDF 的全面安全功能，用密码和权限保护敏感文档：

var pdf = renderer.RenderHtmlAsPdf(html);
// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

var pdf = renderer.RenderHtmlAsPdf(html);
// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

IRON VB CONVERTER ERROR developers@ironsoftware.com

将 MVC 视图转换为 PDF 时，这些安全设置可防止未经授权的访问，并控制收件人与 PDF 的交互方式。 您可以限制打印、复制和编辑，同时保持所有者对管理目的的完全控制。

输出

表单字段处理

IronPDF 可将 HTML 表单无缝转换为交互式 PDF 表单：

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";
var pdf = renderer.RenderHtmlAsPdf(formHtml);

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";
var pdf = renderer.RenderHtmlAsPdf(formHtml);

IRON VB CONVERTER ERROR developers@ironsoftware.com

翻译后的 PDF 将保持表单的交互性，允许用户直接在其 PDF 阅读器中填写字段。 该功能使您无需使用单独的表单创建工具，从而简化了文档工作流程。

输出

CSS 渲染优化

在将 HTML 文件转换为 PDF 格式时，使用打印媒体查询可使复杂 CSS 获得最佳效果：

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

该设置应用了特定于印刷的 CSS 规则，优化了 PDF 输出而非浏览器屏幕显示的布局。 该方法可确保您的文档正确渲染。

JavaScript 执行时间

在转换动态内容和处理数据库中的数据时，请为 MVC 项目中的 JavaScript 执行预留时间。 这一过程可确保完整呈现：

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

IRON VB CONVERTER ERROR developers@ironsoftware.com

该配置可确保在开始生成 PDF 之前完成 AJAX 调用和 DOM 操作，从而将 MVC 视图的完整渲染状态捕捉到 PDF 中。 请注意，这是生成 PDF 文件时处理动态内容的第一步。

输出

。

字体嵌入和文档格式化

通过在 HTML 中嵌入自定义字体，确保其正确呈现。 本示例展示了如何在源代码中创建带有自定义字体的新段落：

@font-face {
    font-family: 'CustomFont';
    src: url(data:font/woff2;base64,[base64-encoded-font]) format('woff2');
}

直接在 HTML 中嵌入字体可以保证在所有环境中呈现一致，消除生成的 PDF 文档中字体缺失的问题。 使用iTextSharp可能需要额外配置才能达到相同效果。 只需编写适当的 CSS 并进行渲染，即可制作出格式完美的专业 PDF。 切记在不同系统上下载并测试最终版本，以确保兼容性。