ZetPDF (zetpdf.com) é um SDK PDF .NET licenciado comercialmente cuja superfície de API se assemelha muito ao PDFsharp — a ponto de a comunidade PDFsharp ter questionado se é um fork fechado. O fornecedor o comercializa como um mecanismo de código gerenciado proprietário, 100%. ZetPDF não é distribuído via NuGet — a instalação é um download de ZIP de https://zetpdf.com/download/ — e o projeto não mostra atividade de lançamento público desde 2021. Os preços são perpétuos: $299 Projeto Único / $449 Multi / $599 OEM.

Este guia fornece um caminho de migração do ZetPDF para o IronPDF, com instruções passo a passo, comparações de código e exemplos para desenvolvedores .NET avaliando esta transição.

Por que migrar do ZetPDF?

A API de desenho em coordenadas, moldada pelo PDFsharp do ZetPDF, apresenta restrições arquitetônicas que limitam os fluxos de trabalho modernos de geração de documentos. Razões comuns pelas quais as equipes consideram a migração:

Coordenadas Baseadas em API: ZetPDF posiciona cada elemento via coordenadas exatas XGraphics. O posicionamento manual cria sobrecarga de manutenção à medida que os requisitos mudam.

Sem Suporte a CSS: Sem sistema de estilo — fontes e cores são geridas por elemento no código.

Sem renderização de JavaScript : Não é possível renderizar conteúdo web dinâmico nem executar JavaScript durante a geração do PDF.

Sem HTML nativo para PDF: A lista de recursos documentada pelo ZetPDF não inclui um conversor de HTML para PDF ou URL para PDF; a renderização é apenas um desenho de baixo nível XGraphics.

Sem NuGet, Lançamentos Inativos: A distribuição é um ZIP do fornecedor em https://zetpdf.com/download/, sem atividade de lançamento público desde 2021.

Quebras de Página Manuais: O estouro de página deve ser calculado e gerenciado manualmente em vez de por meio de paginação automática.

Medida de Texto Necessária: O cálculo manual para a quebra de texto adiciona sobrecarga de desenvolvimento.

O problema fundamental

ZetPDF e PDFsharp forçam você a posicionar cada elemento com coordenadas exatas:

// ZetPDF: Manual positioning nightmare
graphics.DrawString("Name:", font, brush, new XPoint(50, 100));
graphics.DrawString("John Doe", font, brush, new XPoint(100, 100));
graphics.DrawString("Address:", font, brush, new XPoint(50, 120));
graphics.DrawString("123 Main St", font, brush, new XPoint(100, 120));
// ... hundreds of lines for a simple form

// ZetPDF: Manual positioning nightmare
graphics.DrawString("Name:", font, brush, new XPoint(50, 100));
graphics.DrawString("John Doe", font, brush, new XPoint(100, 100));
graphics.DrawString("Address:", font, brush, new XPoint(50, 120));
graphics.DrawString("123 Main St", font, brush, new XPoint(100, 120));
// ... hundreds of lines for a simple form

' ZetPDF: Manual positioning nightmare
graphics.DrawString("Name:", font, brush, New XPoint(50, 100))
graphics.DrawString("John Doe", font, brush, New XPoint(100, 100))
graphics.DrawString("Address:", font, brush, New XPoint(50, 120))
graphics.DrawString("123 Main St", font, brush, New XPoint(100, 120))
' ... hundreds of lines for a simple form

' ZetPDF: Manual positioning nightmare
graphics.DrawString("Name:", font, brush, New XPoint(50, 100))
graphics.DrawString("John Doe", font, brush, New XPoint(100, 100))
graphics.DrawString("Address:", font, brush, New XPoint(50, 120))
graphics.DrawString("123 Main St", font, brush, New XPoint(100, 120))
' ... hundreds of lines for a simple form

O IronPDF usa HTML/CSS — o mecanismo de layout cuida de tudo:

// IronPDF: Simple HTML
var html = @"
<p><strong>Name:</strong> John Doe</p>
<p><strong>Address:</strong> 123 Main St</p>";
var pdf = renderer.RenderHtmlAsPdf(html);

// IronPDF: Simple HTML
var html = @"
<p><strong>Name:</strong> John Doe</p>
<p><strong>Address:</strong> 123 Main St</p>";
var pdf = renderer.RenderHtmlAsPdf(html);

' IronPDF: Simple HTML
Dim html As String = "
<p><strong>Name:</strong> John Doe</p>
<p><strong>Address:</strong> 123 Main St</p>"
Dim pdf = renderer.RenderHtmlAsPdf(html)

' IronPDF: Simple HTML
Dim html As String = "
<p><strong>Name:</strong> John Doe</p>
<p><strong>Address:</strong> 123 Main St</p>"
Dim pdf = renderer.RenderHtmlAsPdf(html)

IronPDF vs ZetPDF: Comparação de Recursos

Compreender as diferenças arquitetônicas ajuda os responsáveis ​​pelas decisões técnicas a avaliar o investimento em migração:

Guia rápido: Migração do ZetPDF para o IronPDF

A migração pode começar imediatamente com esses passos fundamentais.

Etapa 1: Substituir a referência ZetPDF pelo pacote NuGet IronPDF

ZetPDF não está no NuGet — é enviado como um ZIP de https://zetpdf.com/download/ e é referenciado ao adicionar ZetPDF.dll ao seu projeto. Após a migração, você remove essa referência de DLL e instala o IronPDF do NuGet:

# Remove the ZetPDF.dll reference from your csproj manually, then:
dotnet add package IronPdf

# Remove the ZetPDF.dll reference from your csproj manually, then:
dotnet add package IronPdf

Etapa 2: Atualizar Namespaces

Substituir namespaces ZetPDF pelo namespace IronPDF:

// Before (ZetPDF)
using ZetPDF;
using ZetPDF.Drawing;
using ZetPDF.Fonts;

// After (IronPDF)
using IronPdf;

// Before (ZetPDF)
using ZetPDF;
using ZetPDF.Drawing;
using ZetPDF.Fonts;

// After (IronPDF)
using IronPdf;

Imports IronPdf

Imports IronPdf

Etapa 3: Inicializar a licença

Adicionar inicialização de licença na inicialização do aplicativo:

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

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

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

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

Exemplos de migração de código

Converter HTML para PDF

A lista de recursos publicada do ZetPDF não inclui um conversor nativo de HTML para PDF ou URL para PDF — sua superfície documentada cobre visualização/impressão de PDF, anotações, criptografia AES256, campos de formulário e extração de texto. O pseudo-wrapper abaixo é ilustrativo de como as equipes geralmente definem uma entrada de HTML para PDF no ZetPDF; na prática, o trabalho recai para um renderizador HTML externo ou para um desenho de baixo nível XGraphics.

Abordagem ZetPDF (ilustrativa — sem HTML nativo para PDF):

// ZetPDF is NOT on NuGet — install via SDK ZIP from https://zetpdf.com/download/
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        // No native HtmlToPdfConverter exists in ZetPDF — illustrative call only.
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

// ZetPDF is NOT on NuGet — install via SDK ZIP from https://zetpdf.com/download/
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        // No native HtmlToPdfConverter exists in ZetPDF — illustrative call only.
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

Imports ZetPDF
Imports System

Class Program
    Shared Sub Main()
        ' No native HtmlToPdfConverter exists in ZetPDF — illustrative call only.
        Dim converter = New HtmlToPdfConverter()
        Dim htmlContent = "<html><body><h1>Hello World</h1></body></html>"
        converter.ConvertHtmlToPdf(htmlContent, "output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

Imports ZetPDF
Imports System

Class Program
    Shared Sub Main()
        ' No native HtmlToPdfConverter exists in ZetPDF — illustrative call only.
        Dim converter = New HtmlToPdfConverter()
        Dim htmlContent = "<html><body><h1>Hello World</h1></body></html>"
        converter.ConvertHtmlToPdf(htmlContent, "output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

Abordagem IronPDF:

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

Imports IronPdf
Imports System

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim renderer As New ChromePdfRenderer()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Module

Imports IronPdf
Imports System

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim renderer As New ChromePdfRenderer()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Module

IronPDF fornece ChromePdfRenderer com RenderHtmlAsPdf(), que retorna um objeto PdfDocument — você pode salvar em arquivo, recuperar dados binários ou realizar operações adicionais antes de salvar.

Para cenários avançados de conversão de HTML para PDF, consulte o guia de conversão de HTML para PDF .

Converter URLs em PDF

ZetPDF também não tem conversor nativo de URL para PDF; A renderização de HTML/URL não faz parte da lista de recursos documentada. Caminhos de migração práticos normalmente emparelham ZetPDF com um renderizador HTML externo ou movem-se para uma biblioteca baseada em Chromium como IronPDF.

Abordagem ZetPDF (ilustrativa — sem URL nativo para PDF):

// ZetPDF is NOT on NuGet — install via SDK ZIP from https://zetpdf.com/download/
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        // No native ConvertUrlToPdf exists in ZetPDF — illustrative call only.
        var converter = new HtmlToPdfConverter();
        var url = "https://www.example.com";
        converter.ConvertUrlToPdf(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

// ZetPDF is NOT on NuGet — install via SDK ZIP from https://zetpdf.com/download/
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        // No native ConvertUrlToPdf exists in ZetPDF — illustrative call only.
        var converter = new HtmlToPdfConverter();
        var url = "https://www.example.com";
        converter.ConvertUrlToPdf(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

Imports ZetPDF
Imports System

Class Program
    Shared Sub Main()
        ' No native ConvertUrlToPdf exists in ZetPDF — illustrative call only.
        Dim converter As New HtmlToPdfConverter()
        Dim url As String = "https://www.example.com"
        converter.ConvertUrlToPdf(url, "webpage.pdf")
        Console.WriteLine("PDF from URL created successfully")
    End Sub
End Class

Imports ZetPDF
Imports System

Class Program
    Shared Sub Main()
        ' No native ConvertUrlToPdf exists in ZetPDF — illustrative call only.
        Dim converter As New HtmlToPdfConverter()
        Dim url As String = "https://www.example.com"
        converter.ConvertUrlToPdf(url, "webpage.pdf")
        Console.WriteLine("PDF from URL created successfully")
    End Sub
End Class

Abordagem IronPDF:

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        var 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()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        var 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

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim renderer As 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 Module

Imports IronPdf
Imports System

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim renderer As 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 Module

O RenderUrlAsPdf() da IronPDF em ChromePdfRenderer aproveita um mecanismo de renderização completo do Chromium para capturar páginas da web, incluindo a execução de JavaScript e CSS moderno.

Consulte a documentação sobre URLs para PDF para obter informações sobre autenticação e opções de cabeçalho personalizadas.

Unir vários PDFs

ZetPDF não fornece um auxiliar de PdfMerger.MergeFiles() de uma linha. A mesclagem segue o mesmo padrão de PDFsharp (que ZetPDF se assemelha): abra cada entrada com PdfReader, depois repita páginas para uma saída PdfDocument e Save(). O wrapper ilustrativo abaixo espelha a superfície do IronPDF para comparação; no código real do ZetPDF você escreve o loop manual.

Abordagem ZetPDF (ilustrativa — não tem PdfMerger embutido):

// ZetPDF is NOT on NuGet — install via SDK ZIP from https://zetpdf.com/download/
using ZetPDF;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        // ZetPDF has no built-in PdfMerger — illustrative call only.
        var merger = new PdfMerger();
        var files = new List<string> { "document1.pdf", "document2.pdf" };
        merger.MergeFiles(files, "merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}

// ZetPDF is NOT on NuGet — install via SDK ZIP from https://zetpdf.com/download/
using ZetPDF;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        // ZetPDF has no built-in PdfMerger — illustrative call only.
        var merger = new PdfMerger();
        var files = new List<string> { "document1.pdf", "document2.pdf" };
        merger.MergeFiles(files, "merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}

Imports ZetPDF
Imports System
Imports System.Collections.Generic

Module Program
    Sub Main()
        ' ZetPDF has no built-in PdfMerger — illustrative call only.
        Dim merger As New PdfMerger()
        Dim files As New List(Of String) From {"document1.pdf", "document2.pdf"}
        merger.MergeFiles(files, "merged.pdf")
        Console.WriteLine("PDFs merged successfully")
    End Sub
End Module

Imports ZetPDF
Imports System
Imports System.Collections.Generic

Module Program
    Sub Main()
        ' ZetPDF has no built-in PdfMerger — illustrative call only.
        Dim merger As New PdfMerger()
        Dim files As New List(Of String) From {"document1.pdf", "document2.pdf"}
        merger.MergeFiles(files, "merged.pdf")
        Console.WriteLine("PDFs merged successfully")
    End Sub
End Module

Abordagem IronPDF:

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var pdfs = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        };
        var merged = PdfDocument.Merge(pdfs);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var pdfs = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        };
        var merged = PdfDocument.Merge(pdfs);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}

Imports IronPdf
Imports System
Imports System.Collections.Generic

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim pdfs As New List(Of PdfDocument) From {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        }
        Dim merged As PdfDocument = PdfDocument.Merge(pdfs)
        merged.SaveAs("merged.pdf")
        Console.WriteLine("PDFs merged successfully")
    End Sub
End Module

Imports IronPdf
Imports System
Imports System.Collections.Generic

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim pdfs As New List(Of PdfDocument) From {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        }
        Dim merged As PdfDocument = PdfDocument.Merge(pdfs)
        merged.SaveAs("merged.pdf")
        Console.WriteLine("PDFs merged successfully")
    End Sub
End Module

IronPDF carrega documentos como objetos PdfDocument usando PdfDocument.FromFile(), depois os mescla com o método estático PdfDocument.Merge(). A abordagem orientada a objetos permite operações adicionais no documento mesclado antes de salvá-lo.

Consulte a documentação sobre mesclagem de PDFs para obter opções adicionais de mesclagem.

Desenho baseado em coordenadas versus HTML

Para desenvolvedores que já possuem código ZetPDF usando gráficos baseados em coordenadas, o processo de migração envolve a conversão dos comandos de desenho para HTML/CSS.

Abordagem ZetPDF baseada em coordenadas:

using ZetPDF;
using ZetPDF.Drawing;

var document = new PdfDocument();
var page = document.AddPage();
page.Width = XUnit.FromMillimeter(210);
page.Height = XUnit.FromMillimeter(297);

var graphics = XGraphics.FromPdfPage(page);
var titleFont = new XFont("Arial", 24, XFontStyle.Bold);
var bodyFont = new XFont("Arial", 12);

graphics.DrawString("Company Report", titleFont, XBrushes.Navy,
    new XPoint(50, 50));
graphics.DrawString("This is the introduction paragraph.", bodyFont, XBrushes.Black,
    new XPoint(50, 80));
graphics.DrawString("Generated: " + DateTime.Now.ToString(), bodyFont, XBrushes.Gray,
    new XPoint(50, 100));

document.Save("report.pdf");

using ZetPDF;
using ZetPDF.Drawing;

var document = new PdfDocument();
var page = document.AddPage();
page.Width = XUnit.FromMillimeter(210);
page.Height = XUnit.FromMillimeter(297);

var graphics = XGraphics.FromPdfPage(page);
var titleFont = new XFont("Arial", 24, XFontStyle.Bold);
var bodyFont = new XFont("Arial", 12);

graphics.DrawString("Company Report", titleFont, XBrushes.Navy,
    new XPoint(50, 50));
graphics.DrawString("This is the introduction paragraph.", bodyFont, XBrushes.Black,
    new XPoint(50, 80));
graphics.DrawString("Generated: " + DateTime.Now.ToString(), bodyFont, XBrushes.Gray,
    new XPoint(50, 100));

document.Save("report.pdf");

Imports ZetPDF
Imports ZetPDF.Drawing

Dim document As New PdfDocument()
Dim page = document.AddPage()
page.Width = XUnit.FromMillimeter(210)
page.Height = XUnit.FromMillimeter(297)

Dim graphics = XGraphics.FromPdfPage(page)
Dim titleFont As New XFont("Arial", 24, XFontStyle.Bold)
Dim bodyFont As New XFont("Arial", 12)

graphics.DrawString("Company Report", titleFont, XBrushes.Navy, New XPoint(50, 50))
graphics.DrawString("This is the introduction paragraph.", bodyFont, XBrushes.Black, New XPoint(50, 80))
graphics.DrawString("Generated: " & DateTime.Now.ToString(), bodyFont, XBrushes.Gray, New XPoint(50, 100))

document.Save("report.pdf")

Imports ZetPDF
Imports ZetPDF.Drawing

Dim document As New PdfDocument()
Dim page = document.AddPage()
page.Width = XUnit.FromMillimeter(210)
page.Height = XUnit.FromMillimeter(297)

Dim graphics = XGraphics.FromPdfPage(page)
Dim titleFont As New XFont("Arial", 24, XFontStyle.Bold)
Dim bodyFont As New XFont("Arial", 12)

graphics.DrawString("Company Report", titleFont, XBrushes.Navy, New XPoint(50, 50))
graphics.DrawString("This is the introduction paragraph.", bodyFont, XBrushes.Black, New XPoint(50, 80))
graphics.DrawString("Generated: " & DateTime.Now.ToString(), bodyFont, XBrushes.Gray, New XPoint(50, 100))

document.Save("report.pdf")

Abordagem HTML do IronPDF:

using IronPdf;

var html = $@"
<html>
<head>
    <style>
        body {{font-family: Arial, sans-serif; padding: 50px;}}
        h1 {{color: navy;}}
        .date {{color: gray;}}
    </style>
</head>
<body>
    <h1>Company Report</h1>
    <p>This is the introduction paragraph.</p>
    <p class='date'>Generated: {DateTime.Now}</p>
</body>
</html>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("report.pdf");

using IronPdf;

var html = $@"
<html>
<head>
    <style>
        body {{font-family: Arial, sans-serif; padding: 50px;}}
        h1 {{color: navy;}}
        .date {{color: gray;}}
    </style>
</head>
<body>
    <h1>Company Report</h1>
    <p>This is the introduction paragraph.</p>
    <p class='date'>Generated: {DateTime.Now}</p>
</body>
</html>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("report.pdf");

A abordagem ZetPDF exige a criação de objetos de fonte, o cálculo das posições exatas dos pixels e o gerenciamento manual do contexto gráfico. A abordagem do IronPDF utiliza HTML e CSS padrão que os desenvolvedores web já conhecem — fontes, cores e layout são gerenciados por meio de propriedades CSS familiares.

Referência de mapeamento da API ZetPDF para IronPDF

Este mapeamento acelera a migração ao mostrar equivalentes diretos da API:

Problemas e soluções comuns em migrações

Problema 1: Layout baseado em coordenadas

ZetPDF: Tudo requer coordenadas X,Y exatas com posicionamento manual.

Solução: Utilize um layout de fluxo HTML/CSS. Para posicionamento absoluto quando necessário, use CSS:

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

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

Problema 2: Gerenciamento de Objetos de Fonte

ZetPDF: Crie objetos XFont para cada variação de fonte.

Solução: Use CSS font-family — as fontes são gerenciadas automaticamente:

<style>
    body { font-family: Arial, sans-serif; }
    h1 { font-family: 'Times New Roman', serif; font-size: 24px; font-weight: bold; }
</style>

<style>
    body { font-family: Arial, sans-serif; }
    h1 { font-family: 'Times New Roman', serif; font-size: 24px; font-weight: bold; }
</style>

Edição 3: Manipulação de Cores

ZetPDF: Use objetos de XBrushes e cor.

Solução: Utilize cores CSS padrão:

.header { color: navy; background-color: #f5f5f5; }
.warning { color: rgb(255, 0, 0); }

.header { color: navy; background-color: #f5f5f5; }
.warning { color: rgb(255, 0, 0); }

Edição 4: Quebras de página manuais

ZetPDF: Monitore a posição Y e crie novas páginas manualmente quando o conteúdo exceder os limites.

Solução: O IronPDF lida com quebras de página automáticas. Para controle explícito, use CSS:

.section { page-break-after: always; }
.keep-together { page-break-inside: avoid; }

.section { page-break-after: always; }
.keep-together { page-break-inside: avoid; }

Problema 5: Criação de tabela

ZetPDF: Requer desenho manual de retângulos, linhas e posicionamento de texto.

Solução: Utilize tabelas HTML padrão com estilização CSS:

<table style="border-collapse: collapse; width: 100%;">
    <tr>
        <th style="border: 1px solid black; padding: 8px;">Header</th>
    </tr>
    <tr>
        <td style="border: 1px solid black; padding: 8px;">Data</td>
    </tr>
</table>

<table style="border-collapse: collapse; width: 100%;">
    <tr>
        <th style="border: 1px solid black; padding: 8px;">Header</th>
    </tr>
    <tr>
        <td style="border: 1px solid black; padding: 8px;">Data</td>
    </tr>
</table>

Lista de verificação para migração do ZetPDF

Tarefas pré-migração

Faça uma auditoria em seu código-fonte para identificar todos os usos do ZetPDF:

grep -r "using ZetPDF" --include="*.cs" .
grep -r "XGraphics\|XFont\|XBrushes\|PdfReader" --include="*.cs" .

grep -r "using ZetPDF" --include="*.cs" .
grep -r "XGraphics\|XFont\|XBrushes\|PdfReader" --include="*.cs" .

Documento com código de desenho baseado em coordenadas que precisa ser convertido para HTML. Observe os padrões de uso de fontes e cores. Mapear estruturas de layout para seus equivalentes em HTML.

Tarefas de atualização de código

1. Remova a referência manual ZetPDF.dll do seu .csproj
2. Instale o pacote NuGet IronPDF (dotnet add package IronPdf)
3. Atualize as importações de namespace de ZetPDF para IronPdf
4. Substitua qualquer encapsulamento de HTML-para-PDF interno ao redor do ZetPDF por ChromePdfRenderer.RenderHtmlAsPdf()
5. Substitua qualquer encapsulamento de URL-para-PDF por ChromePdfRenderer.RenderUrlAsPdf()
6. Substitua laços de mesclagem manual de cópia de página por PdfDocument.Merge()
7. Converta chamadas DrawString() para elementos de texto HTML
8. Converta XFont para CSS font-family
9. Substitua XBrushes por cores CSS
10. Adicione a inicialização da licença do IronPDF na inicialização (IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";)

Testes pós-migração

Após a migração, verifique os seguintes aspectos:

• Compare a saída visual para garantir que a aparência corresponda ou seja melhorada.
• Verifique se as fontes são renderizadas conforme o esperado com o estilo CSS.
• As quebras de página de teste ocorrem corretamente com a paginação automática.
• Verifique se as imagens estão posicionadas e exibidas corretamente.
• Testar se as operações de mesclagem de PDFs produzem resultados corretos
• Confirme se todas as funcionalidades existentes funcionam com a nova implementação.

Principais benefícios da migração para o IronPDF

A migração do ZetPDF para o IronPDF oferece diversas vantagens cruciais:

Mecanismo de renderização Chromium moderno: O IronPDF usa o Chromium para conversão de HTML em PDF, garantindo suporte completo a CSS3 e JavaScript ES2024. Os frameworks modernos e os designs responsivos são exibidos corretamente.

Criação de conteúdo baseado em HTML: os desenvolvedores web podem aproveitar suas habilidades existentes em HTML e CSS. Não é necessário aprender APIs de desenho baseadas em coordenadas nem gerenciar objetos de fonte.

Layout e paginação automáticos: a quebra de texto, as quebras de página e o layout fluido acontecem automaticamente. Não é necessário calcular manualmente as posições dos elementos.

API simplificada: Chamadas de método único para operações comuns. PdfDocument.Merge() substitui padrões complexos de manipulação de caminhos de arquivos.

Desenvolvimento Ativo: O ritmo de lançamento regular do IronPDF mantém a biblioteca atualizada com as versões modernas do .NET, em contraste com a falta de atividade pública de lançamento do ZetPDF desde 2021.

Conjunto de Recursos Abrangente: Marcação de água embutida, assinaturas digitais, conformidade PDF/A e recursos avançados de manipulação de PDF que estão ausentes da superfície documentada do ZetPDF.