C# para .NET NuGet Sem DLL nativa

A biblioteca PDF para C# para .NET: criar, visualizar e assinar arquivos PDF

O sgcPDF é uma biblioteca PDF para C# em código totalmente gerenciado: crie arquivos PDF em C#, exiba-os em visualizadores WinForms, WPF e Avalonia e assine-os, sem DLL nativa para distribuir.

Criar PDF e converter HTML em PDF em C# Visualizadores WinForms, WPF e Avalonia Assinaturas PAdES, PDF/A e PDF/UA PDF para PNG no Windows, Linux e macOS

Ver preços →   Downloads e demonstrações .NET →

sgcPDF convertendo uma página HTML com CSS em um PDF: o código-fonte HTML à esquerda e o resumo trimestral de pedidos renderizado, com títulos, uma tabela de pedidos, um total e uma lista com marcadores, à direita

O que o sgcPDF produz e exibe

Documentos gerados em código, páginas renderizadas como imagens, formulários, redação e códigos de barras, tudo a partir da mesma biblioteca PDF gerenciada para .NET.

Como criar um PDF em C#

Como gerador de PDF em C# para faturas, relatórios e ingressos, o sgcPDF precisa de quatro passos: criar um TsgcPDFDocument, adicionar uma página com AddPage, desenhar nela e chamar SaveToFile. As coordenadas estão em pontos PDF (1/72 de polegada) com a origem no canto inferior esquerdo da página. Todos os tipos estão no namespace esegece.sgcPDF.

Program.cs
using System;
using esegece.sgcPDF;

class Program
{
    static void Main()
    {
        using (TsgcPDFDocument oDoc = new TsgcPDFDocument())
        {
            oDoc.Info.Title = "Invoice 2026-001";
            // A4 portrait: 595 x 842 points, origin at the bottom left corner
            TsgcPDFPage oPage = oDoc.AddPage(595, 842);
            oPage.DrawText("Invoice 2026-001", 50, 780, TsgcPDFStandardFont.sfHelveticaBold, 24);
            oPage.DrawLine(50, 770, 545, 770, 1.0);
            oPage.DrawText("Created in C# with sgcPDF.", 50, 740, TsgcPDFStandardFont.sfHelvetica, 12);
            oDoc.SaveToFile("invoice.pdf");
        }
    }
}

Conteúdo

Texto nas 14 fontes PDF padrão ou em fontes TrueType e OpenType incorporadas e com subconjunto, texto Unicode e da direita para a esquerda, imagens (JPEG, PNG com alfa, BMP, TIFF), linhas, curvas, gradientes e transparência, tabelas que continuam entre páginas, anotações, marcadores e camadas.

Edite arquivos existentes

TsgcPDFEditor adiciona marcas d'água, cabeçalhos, rodapés e números de página, insere páginas em branco e extrai, exclui, gira e move páginas. Una arquivos com sgcPDF_Editor.sgcPDFMergeFiles. O salvamento incremental acrescenta uma revisão e mantém válidas as assinaturas anteriores.

Extrair

ExtractTextW retorna o texto de uma página, TsgcPDFTextExtractor fornece fragmentos de texto com posições, e TsgcPDFImageExtractor lista e salva as imagens de um PDF.

HTML para PDF em C#

TsgcPDFHTMLRenderer transforma HTML com CSS em um PDF paginado: títulos, parágrafos, estilos inline, listas, tabelas, imagens, links, quebras de página, cabeçalhos, rodapés e números de página.

using (TsgcPDFHTMLRenderer oHTML = new TsgcPDFHTMLRenderer())
{
    oHTML.PageWidth = 595;
    oHTML.PageHeight = 842;
    oHTML.FooterText = "Page {page} of {pages}";
    oHTML.HTMLToPDFFile(
        "<html><head><style>h1 { color: #003366 }</style></head><body>" +
        "<h1>Invoice 2026-001</h1>" +
        "<table><tr><th>Item</th><th>Amount</th></tr>" +
        "<tr><td>Consulting</td><td>299.00</td></tr></table>" +
        "</body></html>", "invoice-html.pdf");
}

// merge the two files into one
sgcPDF_Editor.sgcPDFMergeFiles(new string[] { "invoice.pdf", "invoice-html.pdf" }, "merged.pdf");

Gere códigos de barras e QR codes em C#

Code 128, Code 39, EAN-13, EAN-8, UPC-A, ITF, Codabar, GS1-128, QR Code, DataMatrix (ECC200) e PDF417 são desenhados como vetores em uma página PDF. TsgcPDFBarcodeControl (WinForms), TsgcWpfPDFBarcodeControl e TsgcAvaloniaPDFBarcodeControl os exibem na tela e os salvam em PNG ou SVG.

// Code 128 barcode in a 250 x 60 point box, black on white
TsgcPDFBarcodeSymbol oSymbol = new TsgcPDFBarcodeSymbol();
oSymbol.Symbology = TsgcPDFBarcodeType.bcCode128;
oSymbol.Text = "TKT-2026-001";
oSymbol.DrawToPDF(oPage, 50, 680, 250, 60, 0x000000, 0xFFFFFF);

// QR Code in a 120 x 120 point box
oSymbol.Symbology = TsgcPDFBarcodeType.bcQRCode;
oSymbol.QRErrorLevel = TsgcPDFQRErrorLevel.qrecQ;
oSymbol.Text = "https://www.esegece.com";
oSymbol.DrawToPDF(oPage, 50, 540, 120, 120, 0x000000, 0xFFFFFF);

Visualizador de PDF para C# em WinForms, WPF e Avalonia

Três controles visualizadores nativos, cada um com uma visualização de miniaturas e uma visualização de estrutura (marcadores). As páginas são desenhadas pelos renderizadores C# do sgcPDF, então não há engine PDF nativo para distribuir com o seu aplicativo.

Visualizador de PDF WinForms

TsgcPDFViewerControl, TsgcPDFThumbnailView e TsgcPDFOutlineView em esegece.sgcPDF.WinForms, para .NET Framework 4.7.2 e .NET 8 no Windows. Anotações interativas e respostas a comentários, preenchimento de formulários, caixas de página e uma ferramenta de medição.

Visualizador de PDF WPF

TsgcWpfPDFViewer, TsgcWpfPDFThumbnailView e TsgcWpfPDFOutlineView em esegece.sgcPDF.Wpf, para .NET Framework 4.7.2 e .NET 8, 9 e 10 no Windows. Propriedades de dependência que você pode vincular, e páginas renderizadas em uma thread em segundo plano para que a UI continue responsiva com arquivos grandes.

Visualizador de PDF Avalonia

TsgcAvaloniaPDFViewer, TsgcAvaloniaPDFThumbnailView e TsgcAvaloniaPDFOutlineView em esegece.sgcPDF.Avalonia, para .NET 8, 9 e 10 no Windows, Linux e macOS, com os recursos do visualizador WPF mais zoom por pinça.

Os três visualizadores oferecem layouts contínuo, de página única e de duas páginas, ajuste à largura, à página e zoom personalizado, zoom por seleção, seleção e cópia de texto, busca com ocorrências destacadas, links, edição de anotações com notas adesivas, destaques, formas, tinta e carimbos, e preenchimento de formulários. Veja a página do visualizador de PDF para a lista completa de recursos.

MainForm.cs
using System.Windows.Forms;
using esegece.sgcPDF;

public class MainForm : Form
{
    TsgcPDFThumbnailView FThumbnails;
    TsgcPDFViewerControl FViewer;

    public MainForm()
    {
        Width = 1100;
        Height = 800;
        // page thumbnails on the left
        FThumbnails = new TsgcPDFThumbnailView();
        FThumbnails.Parent = this;
        FThumbnails.Dock = DockStyle.Left;
        FThumbnails.Width = 160;
        // the viewer fills the rest of the form
        FViewer = new TsgcPDFViewerControl();
        FViewer.Parent = this;
        FViewer.Dock = DockStyle.Fill;
        FViewer.BringToFront();
        FViewer.ZoomMode = TsgcPDFViewerZoomMode.zmFitWidth;
        FThumbnails.Viewer = FViewer;
        FViewer.LoadFromFile("invoice.pdf");
    }
}
ViewerWindow.xaml
<Window x:Class="MyApp.ViewerWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:sgc="https://www.esegece.com/sgcui"
        Title="PDF Viewer" Width="1100" Height="800">
  <DockPanel>
    <sgc:TsgcWpfPDFThumbnailView DockPanel.Dock="Left" Width="160"
                                 Viewer="{Binding ElementName=Viewer}" ThumbnailWidth="120" />
    <sgc:TsgcWpfPDFViewer x:Name="Viewer" Source="invoice.pdf"
                          ZoomMode="zmFitWidth" ViewMode="pvmContinuous" />
  </DockPanel>
</Window>

No code-behind, Viewer.LoadFromFile, Viewer.FindText e Viewer.PrintDialog abrem, pesquisam e imprimem o documento. Todos os produtos sgcUI usam o namespace XAML https://www.esegece.com/sgcui.

Converta uma página PDF em imagem em C#

TsgcPDFRendererRaster renderiza uma página em PNG ou BMP em código gerenciado. Ele funciona em todas as plataformas em que o .NET roda, então uma API web ou um serviço em segundo plano em um servidor Linux pode criar miniaturas e visualizações. No Windows, o pacote WinForms adiciona o renderizador GDI e a exportação de páginas para imagens.

using (TsgcPDFDocument oDoc = new TsgcPDFDocument())
{
    oDoc.LoadFromFile("invoice.pdf");
    TsgcPDFPage oPage = oDoc.GetPage(0);
    // 144 DPI: a PDF point is 1/72 inch
    int vWidth = (int)Math.Round(oPage.Width * 144 / 72);
    int vHeight = (int)Math.Round(oPage.Height * 144 / 72);
    TsgcPDFRendererRaster oRenderer = new TsgcPDFRendererRaster();
    oRenderer.RenderPageToPNG(oDoc.Parser, oPage.PageDict, vWidth, vHeight, "page1.png");
}

Assine um PDF em C#

TsgcPDFSignatureHandler assina um PDF com um certificado PFX e um campo de assinatura visível, e TsgcPDFSignatureVerifier verifica as assinaturas de um arquivo. No .NET, as assinaturas usam System.Security.Cryptography. A assinatura com o repositório de certificados do Windows exige o Windows.

using (TsgcPDFSignatureHandler oSigner = new TsgcPDFSignatureHandler())
{
    oSigner.LoadCertificateFromPFX("signer.pfx", "password");
    oSigner.Reason = "Contract approval";
    oSigner.Location = "Barcelona";
    // visible signature field on page 1: name, page, left, bottom, right, top
    oSigner.SetField("Signature1", 0, 50, 50, 300, 120);
    oSigner.SignDocument("contract.pdf", "contract-signed.pdf");
}

PAdES B-B a B-LTA

O pacote opcional esegece.sgcPDF.sgcSign adiciona TsgcPDFPAdESSigner, que assina em PAdES B-B, B-T, B-LT e B-LTA com qualquer provedor de chaves do sgcSign .NET, licenciado separadamente.

Assinaturas manuscritas

TsgcPDFSignaturePad (WinForms), TsgcWpfPDFSignaturePad, que lê a pressão da caneta stylus, e TsgcAvaloniaPDFSignaturePad registram uma assinatura com o mouse, o dedo ou uma caneta.

PDF/A, PDF/UA, criptografia e redação

O pacote esegece.sgcPDF cobre arquivamento, acessibilidade e segurança, com uma demonstração .NET compilada para cada um deles.

PDF/A

Saída PDF/A-1b, PDF/A-2b e PDF/A-3b com fontes TrueType incorporadas, PDF/A-4, e TsgcPDFAValidator para verificar um arquivo. Arquivos incorporados com relações PDF/A-3 transportam faturas eletrônicas Factur-X.

PDF/UA e PDF com tags

PDF com tags, com uma árvore de estrutura e texto alternativo para figuras, saída PDF/UA-1 (também como PDF/A-2a) e PDF/UA-2, para que os leitores de tela acompanhem o documento.

Criptografia

Proteção por senha com RC4-128, AES-128 ou AES-256 e permissões, ou criptografia para um ou mais certificados de destinatário.

Redação

TsgcPDFRedactor remove texto e áreas do conteúdo, então os dados redigidos somem do arquivo, em vez de ficarem escondidos sob uma caixa.

Formulários

Crie AcroForms com campos de texto, caixas de combinação, caixas de seleção e botões, preencha-os a partir do código e exporte e importe os seus dados.

Pré-impressão

Caixas de página, imposição com marcas de corte, cores especiais, visualização de sobreimpressão e uma intenção de saída PDF/X. Veja os recursos de pré-impressão.

Instale a biblioteca PDF para C# pelo NuGet

Somente esegece.sgcPDF é obrigatório. Adicione o pacote WinForms, WPF ou Avalonia para os controles visualizadores do seu framework de UI, e o pacote sgcSign para assinaturas PAdES. No Visual Studio, use Manage NuGet Packages e procure por esegece.sgcPDF.

dotnet add package esegece.sgcPDF
dotnet add package esegece.sgcPDF.WinForms
dotnet add package esegece.sgcPDF.Wpf
dotnet add package esegece.sgcPDF.Avalonia
dotnet add package esegece.sgcPDF.sgcSign

Para a edição Community gratuita, use os mesmos ids de pacote com o sufixo .Community, por exemplo dotnet add package esegece.sgcPDF.Community. Referencie apenas uma das duas edições em um projeto. Veja o guia de instalação para .NET e as diferenças da API .NET.

Versões e plataformas do .NET

O pacote principal roda onde quer que o .NET rode, incluindo Windows, Linux e macOS. O destino netstandard2.0 também alcança o .NET Framework 4.6.2 e posteriores e o Mono. As únicas dependências de terceiros são System.Security.Cryptography.Pkcs e, em netstandard2.0 e net472, System.Memory.

PacoteFrameworks de destinoSistemas operacionais
esegece.sgcPDFnetstandard2.0, net472, net6.0, net8.0, net9.0, net10.0Windows, Linux, macOS
esegece.sgcPDF.WinFormsnet472, net8.0-windowsWindows
esegece.sgcPDF.Wpfnet472, net8.0-windows, net9.0-windows, net10.0-windowsWindows
esegece.sgcPDF.Avalonianet8.0, net9.0, net10.0, com Avalonia 12.0.0 ou posteriorWindows, Linux, macOS
esegece.sgcPDF.sgcSignnetstandard2.0, net472, net6.0, net8.0, net9.0, net10.0Depende de esegece.sgcSign

As demonstrações .NET incluem 26 demonstrações Windows Forms para criação, códigos de barras, formulários, criptografia, assinaturas, PDF/A, PDF com tags, extração de texto e o visualizador, além de demonstrações WPF e Avalonia do visualizador, do pad de assinatura, do editor de imagens e do controle de código de barras. Leia sobre as demonstrações .NET.

Edições Community e Registered

As duas edições têm os mesmos recursos. Elas diferem na licença, não na capacidade.

Community, gratuito

Os pacotes .Community são gratuitos para uso comercial e não comercial por pessoas físicas e organizações com receita bruta anual abaixo de EUR 1M e no máximo 5 desenvolvedores. Eles exibem um breve aviso na inicialização. Organizações que atingem ou superam qualquer um dos limites precisam de uma licença Registered.

esegece.sgcPDF.Community no NuGet →

Registered

Remove o aviso de inicialização e inclui a licença comercial. Licenças Single, Team e Site, cada uma com código-fonte completo, 1 ano de atualizações e um desconto de renovação de 50% a 70%.

Preços do sgcPDF .NET →

sgcPDF .NET

€249

Licenças Single, Team e Site disponíveis.

  • NuGet: esegece.sgcPDF e os pacotes WinForms, WPF, Avalonia e sgcSign
  • .NET Standard 2.0, .NET Framework 4.7.2, .NET 6, .NET 8, .NET 9, .NET 10
  • Código-fonte completo
  • 1 ano de atualizações

Perguntas sobre PDF em C#

Adicione o pacote NuGet esegece.sgcPDF (ou esegece.sgcPDF.Community), crie um TsgcPDFDocument, adicione uma página com AddPage, desenhe texto, linhas, imagens, tabelas e códigos de barras nela e chame SaveToFile, como no exemplo de criação de PDF. Para converter HTML com CSS, chame HTMLToPDFFile de TsgcPDFHTMLRenderer.

A melhor escolha é a biblioteca que cobre o que o seu aplicativo faz. O sgcPDF cobre todo o ciclo de vida do PDF em uma única biblioteca .NET gerenciada: criar, editar, unir, extrair, visualizar em WinForms, WPF e Avalonia, renderizar em imagens, criptografar, assinar, aplicar redação e validar PDF/A, sem DLL nativa e com o código-fonte C# completo em todas as licenças. Os pacotes Community gratuitos têm os mesmos recursos, então você pode testar o sgcPDF com os seus próprios documentos antes de decidir.

Sim. TsgcWpfPDFViewer no pacote esegece.sgcPDF.Wpf é um controle WPF cujas páginas são renderizadas pelo renderizador gerenciado do sgcPDF em uma thread em segundo plano. Nada nativo é distribuído. Ele roda no .NET Framework 4.7.2 e no .NET 8, 9 e 10 no Windows. Para WinForms use TsgcPDFViewerControl, e para Avalonia no Windows, Linux e macOS use TsgcAvaloniaPDFViewer.

Carregue o arquivo em um TsgcPDFDocument e chame RenderPageToPNG de TsgcPDFRendererRaster com a página e o tamanho em pixels, como no exemplo de PDF para imagem. O renderizador raster grava PNG ou BMP e funciona no Windows, Linux e macOS, então também roda em servidores.

Sim. TsgcPDFSignatureHandler assina com um certificado PFX e um campo de assinatura visível, e TsgcPDFSignatureVerifier verifica assinaturas. Para PAdES B-B, B-T, B-LT e B-LTA, adicione esegece.sgcPDF.sgcSign: TsgcPDFPAdESSigner funciona com qualquer provedor de chaves do sgcSign .NET, que é licenciado separadamente.

Sim. Todo pacote NuGet do sgcPDF também é distribuído como uma edição Community gratuita com o sufixo .Community e os mesmos recursos. Ela é gratuita para pessoas físicas e organizações com receita bruta anual abaixo de EUR 1M e no máximo 5 desenvolvedores, e exibe um breve aviso na inicialização. Organizações maiores precisam de uma licença Registered, veja os preços do sgcPDF.

A biblioteca tem como destino .NET Standard 2.0, .NET Framework 4.7.2, .NET 6, .NET 8, .NET 9 e .NET 10. O visualizador WinForms tem como destino .NET Framework 4.7.2 e .NET 8 no Windows, o visualizador WPF .NET Framework 4.7.2, .NET 8, .NET 9 e .NET 10 no Windows, e o visualizador Avalonia .NET 8, .NET 9 e .NET 10.

Sim. O pacote esegece.sgcPDF roda onde quer que o .NET rode, incluindo Linux e macOS, e o visualizador Avalonia roda no Windows, Linux e macOS. Os pacotes WinForms e WPF são para Windows. Fora do Windows, carregue fontes TrueType de arquivos com AddTrueTypeFontFromFile.

Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Adicione PDF ao seu aplicativo .NET

Crie, visualize, assine e arquive arquivos PDF a partir do C#, com uma única biblioteca gerenciada e sem DLL nativa.