Como migrar do PDFPrinting.NET para o IronPDF em C#

Entendendo a impressão em PDF no .NET

O PDFPrinting .NET destaca-se como uma solução especializada que oferece simplicidade e eficácia incomparáveis ​​na impressão silenciosa de PDFs. Operando principalmente dentro do ecossistema Windows, o PDFPrinting .NET é uma biblioteca comercial projetada especificamente para atender desenvolvedores que precisam integrar recursos de impressão em PDF em seus aplicativos. Como uma ferramenta dedicada exclusivamente à impressão silenciosa e robusta de PDFs, o PDFPrinting .NET encontra seu nicho ao simplificar a tarefa, muitas vezes complexa, de imprimir documentos programaticamente sem intervenção do usuário.

Uma das vantagens mais significativas do PDFPrinting .NET é a sua capacidade de imprimir documentos silenciosamente. Ele ignora as janelas de diálogo de impressão usuais, facilitando processos de fluxo de trabalho totalmente automatizados, o que é crucial para aplicativos que exigem interação mínima do usuário.

A limitação de impressão apenas

Uma limitação notável do PDFPrinting .NET é que ele aborda apenas o aspecto de impressão do processamento de PDF. Não consegue criar, modificar ou manipular documentos PDF, o que limita sua utilidade para desenvolvedores que precisam de soluções para todo o ciclo de vida de um documento PDF:

1. Somente impressão: Não é possível criar, editar ou manipular documentos PDF.

2. Somente Windows: Vinculado à infraestrutura de impressão do Windows — sem suporte para Linux/macOS. A dependência da infraestrutura de impressão do Windows restringe sua aplicabilidade a ambientes exclusivamente Windows, limitando a usabilidade multiplataforma.

3. Sem geração de PDF: Não é possível converter HTML, URLs ou dados para PDF.

4. Sem manipulação de documentos: Não é possível mesclar, dividir, adicionar marcas d'água ou proteger PDFs.

5. Sem extração de texto: Não é possível ler ou extrair conteúdo de PDFs.

6. Sem suporte para formulários: Não é possível preencher ou achatar formulários PDF.

Comparação entre PDFPrinting .NET e IronPDF

O IronPDF apresenta uma solução mais abrangente, abordando todo o ciclo de vida do processamento de PDFs. Facilita a criação, edição, conversão e impressão de documentos PDF, oferecendo aos desenvolvedores um conjunto completo de recursos por meio de uma API unificada. Diferentemente do PDFPrinting .NET, o IronPDF pode ser implementado em diferentes plataformas, tornando-se uma opção versátil para aplicações que operam em diversos ambientes.

Para equipes que planejam a adoção do .NET 10 e do C# 14 até 2025 e 2026, o IronPDF oferece uma solução completa de PDF que funciona em ambientes Windows, Linux e macOS.

Pré-requisitos

1. Ambiente .NET : .NET Framework 4.6.2+ ou .NET Core 3.1+ / .NET 5/6/7/8/9+
2. Acesso ao NuGet : Capacidade de instalar pacotes NuGet.
3. Licença do IronPDF : Obtenha sua chave de licença em IronPDF

Alterações no pacote NuGet

# Remove PDFPrinting.NET
dotnet remove package PDFPrinting.NET

# Install IronPDF
dotnet add package IronPdf

# Remove PDFPrinting.NET
dotnet remove package PDFPrinting.NET

# Install IronPDF
dotnet add package IronPdf

Configuração de licença

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

Identificar o uso do PDFPrinting .NET

# Find PDFPrinting.NET usage
grep -r "PDFPrinting\|PDFPrinter" --include="*.cs" .

# Find print-related code
grep -r "\.Print(\|PrinterName\|GetPrintDocument" --include="*.cs" .

# Find PDFPrinting.NET usage
grep -r "PDFPrinting\|PDFPrinter" --include="*.cs" .

# Find print-related code
grep -r "\.Print(\|PrinterName\|GetPrintDocument" --include="*.cs" .

Alterações de namespace

// Before: PDFPrinting.NET
using PDFPrinting.NET;
using PDFPrintingNET;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Printing;

// Before: PDFPrinting.NET
using PDFPrinting.NET;
using PDFPrintingNET;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Printing;

' Before: PDFPrinting.NET
Imports PDFPrinting.NET
Imports PDFPrintingNET

' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering
Imports IronPdf.Printing

Mapeamentos de Classes Principais

Mapeamentos de Métodos de Impressão

Novos recursos não disponíveis no PDFPrinting .NET

Exemplo 1: Conversão de HTML para PDF

Antes (PDFPrinting .NET):

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

Imports PDFPrinting.NET
Imports System

Class Program
    Shared Sub Main()
        Dim converter As New HtmlToPdfConverter()
        Dim html As String = "<html><body><h1>Hello World</h1></body></html>"
        converter.ConvertHtmlToPdf(html, "output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

Após (IronPDF):

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

class Program
{
    static void Main()
    {
        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");
    }
}

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

class Program
{
    static void Main()
    {
        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");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim html As String = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

PDFPrinting .NET usa HtmlToPdfConverter com ConvertHtmlToPdf(html, outputPath) que combina renderização e salvamento em uma única chamada. IronPDF usa ChromePdfRenderer com RenderHtmlAsPdf() que retorna um objeto PdfDocument que você então salva com SaveAs(). Essa separação proporciona mais flexibilidade — você pode manipular o PDF (adicionar marcas d'água, mesclar com outros documentos, adicionar segurança) antes de salvar.

O IronPDF oferece funcionalidades como a conversão de HTML para PDF, que permite aos desenvolvedores renderizar conteúdo da web como PDFs, aproveitando as tecnologias web modernas para a criação de documentos. Ao utilizar os mecanismos internos dos navegadores, o IronPDF replica com precisão o estilo e a renderização de documentos da web em PDFs. Consulte a documentação de conversão de HTML para PDF para obter exemplos completos.

Exemplo 2: Conversão de URL para PDF

Antes (PDFPrinting .NET):

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new WebPageToPdfConverter();
        string url = "https://www.example.com";
        converter.Convert(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new WebPageToPdfConverter();
        string url = "https://www.example.com";
        converter.Convert(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

Imports PDFPrinting.NET
Imports System

Class Program
    Shared Sub Main()
        Dim converter As New WebPageToPdfConverter()
        Dim url As String = "https://www.example.com"
        converter.Convert(url, "webpage.pdf")
        Console.WriteLine("PDF from URL created successfully")
    End Sub
End Class

Após (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim url As String = "https://www.example.com"
        Dim pdf = renderer.RenderUrlAsPdf(url)
        pdf.SaveAs("webpage.pdf")
        Console.WriteLine("PDF from URL created successfully")
    End Sub
End Class

PDFPrinting .NET usa WebPageToPdfConverter com Convert(url, outputPath). IronPDF usa a mesma classe ChromePdfRenderer com o método RenderUrlAsPdf(). Note que o IronPDF usa uma única classe de renderização tanto para strings HTML quanto para URLs, simplificando seu código quando você precisa de ambas as funcionalidades. Saiba mais em nossos tutoriais .

Exemplo 3: Cabeçalhos e Rodapés

Antes (PDFPrinting .NET):

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.HeaderText = "Company Report";
        converter.FooterText = "Page {page} of {total}";
        string html = "<html><body><h1>Document Content</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.HeaderText = "Company Report";
        converter.FooterText = "Page {page} of {total}";
        string html = "<html><body><h1>Document Content</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

Imports PDFPrinting.NET
Imports System

Class Program
    Shared Sub Main()
        Dim converter As New HtmlToPdfConverter()
        converter.HeaderText = "Company Report"
        converter.FooterText = "Page {page} of {total}"
        Dim html As String = "<html><body><h1>Document Content</h1></body></html>"
        converter.ConvertHtmlToPdf(html, "report.pdf")
        Console.WriteLine("PDF with headers/footers created")
    End Sub
End Class

Após (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        string html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        string html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

Imports IronPdf
Imports IronPdf.Rendering
Imports System

Class Program
    Shared Sub Main()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        }
        renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        }
        Dim html As String = "<html><body><h1>Document Content</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("report.pdf")
        Console.WriteLine("PDF with headers/footers created")
    End Sub
End Class

O PDFPrinting .NET usa propriedades de string simples HeaderText e FooterText com marcadores de posição {page} e {total}. O IronPDF usa objetos HtmlHeaderFooter com uma propriedade HtmlFragment que aceita HTML completo, permitindo estilização avançada com CSS. Observe a alteração na sintaxe do marcador de posição: PDFPrinting .NET usa {total} enquanto IronPDF usa {total-pages}.

Alteração de sintaxe do marcador de posição

Os espaços reservados para cabeçalho/rodapé variam entre as bibliotecas:

// PDFPrinting.NET placeholders
"Page {page} of {total}"

// IronPDF placeholders
"Page {page} of {total-pages}"

// PDFPrinting.NET placeholders
"Page {page} of {total}"

// IronPDF placeholders
"Page {page} of {total-pages}"

' PDFPrinting.NET placeholders
"Page {page} of {total}"

' IronPDF placeholders
"Page {page} of {total-pages}"

Padrão de Carregar e Imprimir

O PDFPrinting .NET passa os caminhos dos arquivos diretamente; O IronPDF é carregado primeiro:

// PDFPrinting.NET: Direct path to Print()
printer.Print("document.pdf");

// IronPDF: Load first, then operate
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Print();

// PDFPrinting.NET: Direct path to Print()
printer.Print("document.pdf");

// IronPDF: Load first, then operate
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Print();

' PDFPrinting.NET: Direct path to Print()
printer.Print("document.pdf")

' IronPDF: Load first, then operate
Dim pdf = PdfDocument.FromFile("document.pdf")
pdf.Print()

Migração de configurações de impressão

O PDFPrinting .NET utiliza propriedades; O IronPDF utiliza um objeto de configurações:

// PDFPrinting.NET: Properties on printer object
printer.Copies = 2;
printer.Duplex = true;

// IronPDF: Settings object
var settings = new PrintSettings
{
    NumberOfCopies = 2,
    DuplexMode = System.Drawing.Printing.Duplex.Vertical
};
pdf.Print(settings);

// PDFPrinting.NET: Properties on printer object
printer.Copies = 2;
printer.Duplex = true;

// IronPDF: Settings object
var settings = new PrintSettings
{
    NumberOfCopies = 2,
    DuplexMode = System.Drawing.Printing.Duplex.Vertical
};
pdf.Print(settings);

' PDFPrinting.NET: Properties on printer object
printer.Copies = 2
printer.Duplex = True

' IronPDF: Settings object
Dim settings As New PrintSettings With {
    .NumberOfCopies = 2,
    .DuplexMode = System.Drawing.Printing.Duplex.Vertical
}
pdf.Print(settings)

Cabeçalhos HTML vs. Cabeçalhos de Texto

// PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report";

// IronPDF: HTML completo with styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};

// PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report";

// IronPDF: HTML completo with styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};

' PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report"

' IronPDF: HTML completo with styling
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center'>Company Report</div>"
}

Fusão de PDFs

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged.pdf")

Marcas d'água

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>")

Proteção por senha

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword"
pdf.SecuritySettings.OwnerPassword = "ownerpassword"

Extração de texto

string text = pdf.ExtractAllText();

string text = pdf.ExtractAllText();

Dim text As String = pdf.ExtractAllText()

Fluxo de trabalho Gerar e Imprimir

Com o IronPDF, você pode gerar PDFs e imprimi-los em um único fluxo de trabalho:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>");
pdf.Print("Invoice Printer");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>");
pdf.Print("Invoice Printer");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>")
pdf.Print("Invoice Printer")

Windows

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet")

Linux

// Requires CUPS (Common Unix Printing System)
// Install: apt-get install cups
pdf.Print("HP_LaserJet");  // CUPS uses underscores instead of spaces

// Requires CUPS (Common Unix Printing System)
// Install: apt-get install cups
pdf.Print("HP_LaserJet");  // CUPS uses underscores instead of spaces

macOS

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet")

Pré-migração

• Inventariar todo o uso de PDFPrinting .NET no código-fonte.
• Documente todos os nomes de impressoras atualmente em uso.
• Anote todas as configurações de impressão.
• Identificar se é necessário suporte multiplataforma
• Planeje o armazenamento da chave de licença do IronPDF (variáveis ​​de ambiente recomendadas)
• Teste primeiro com a licença de avaliação do IronPDF

Alterações no pacote

• Remover o pacote NuGet PDFPrinting.NET
• Instale o pacote NuGet IronPdf: dotnet add package IronPdf

Alterações no código

• Atualizar importações de namespace
• Substitua HtmlToPdfConverter por ChromePdfRenderer
• Substitua WebPageToPdfConverter por ChromePdfRenderer
• Substitua ConvertHtmlToPdf(html, path) por RenderHtmlAsPdf(html).SaveAs(path)
• Substitua Convert(url, path) por RenderUrlAsPdf(url).SaveAs(path)
• Atualizar cabeçalho/rodapé de FooterText para HtmlFooter
• Atualizar sintaxe do marcador de posição ({total} → {total-pages})
• Converter chamadas de impressão para o padrão carregar-e-imprimir
• Atualize as configurações de impressão para o objeto PrintSettings

Pós-migração

• Teste de impressão em todas as plataformas de destino
• Verificar a renderização do cabeçalho/rodapé
• Considere adicionar a geração de PDFs para documentos dinâmicos.
• Adicionar novas funcionalidades (fusão, marcas d'água, segurança) conforme necessário.