La libreria PDF C# per .NET: crea, visualizza e firma file PDF
sgcPDF è una libreria PDF C# in codice interamente gestito: crea file PDF in C#, mostrali nei visualizzatori WinForms, WPF e Avalonia, e firmali, senza DLL native da distribuire.
sgcPDF è una libreria PDF C# in codice interamente gestito: crea file PDF in C#, mostrali nei visualizzatori WinForms, WPF e Avalonia, e firmali, senza DLL native da distribuire.
Documenti generati in codice, pagine renderizzate in immagini, moduli, oscuramento e codici a barre, tutto dalla stessa libreria PDF .NET gestita.
Una fattura generata in codice con TsgcPDFDocument: banda di intestazione, tabella delle righe e totali.
Il visualizzatore sgcPDF con miniature, modalità di zoom, ricerca, stampa e strumenti di annotazione. I visualizzatori WinForms, WPF e Avalonia condividono queste funzionalità.
Pagine PDF renderizzate in PNG a 144 DPI dal renderer raster gestito, senza GDI.
Un modulo PDF compilabile: gli utenti scrivono nei campi e spuntano le caselle di controllo, il tuo codice salva il risultato.
L'oscuramento vero con TsgcPDFRedactor rimuove il testo dal file invece di coprirlo.
Undici simbologie di codici a barre, compresi QR Code, DataMatrix e PDF417, salvate come PNG, SVG o disegnate su una pagina PDF.
Come generatore PDF C# per fatture, report e biglietti, sgcPDF richiede quattro passaggi: crea un TsgcPDFDocument, aggiungi una pagina con AddPage, disegna su di essa e chiama SaveToFile. Le coordinate sono in punti PDF (1/72 di pollice) con l'origine nell'angolo in basso a sinistra della pagina. Ogni tipo è nel namespace esegece.sgcPDF.
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");
}
}
}
Testo nei 14 font PDF standard o in font TrueType e OpenType incorporati e con subset, testo Unicode e da destra a sinistra, immagini (JPEG, PNG con alfa, BMP, TIFF), linee, curve, sfumature e trasparenza, tabelle che continuano su più pagine, annotazioni, segnalibri e livelli.
TsgcPDFEditor aggiunge filigrane, intestazioni, piè di pagina e numeri di pagina, inserisce pagine vuote, ed estrae, elimina, ruota e sposta pagine. Unisci file con sgcPDF_Editor.sgcPDFMergeFiles. Il salvataggio incrementale aggiunge una revisione e mantiene valide le firme precedenti.
ExtractTextW restituisce il testo di una pagina, TsgcPDFTextExtractor fornisce frammenti di testo con le posizioni, e TsgcPDFImageExtractor elenca e salva le immagini di un PDF.
TsgcPDFHTMLRenderer trasforma HTML con CSS in un PDF impaginato: titoli, paragrafi, stili inline, elenchi, tabelle, immagini, collegamenti, interruzioni di pagina, intestazioni, piè di pagina e numeri di pagina.
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");
Code 128, Code 39, EAN-13, EAN-8, UPC-A, ITF, Codabar, GS1-128, QR Code, DataMatrix (ECC200) e PDF417 vengono disegnati come vettori su una pagina PDF. TsgcPDFBarcodeControl (WinForms), TsgcWpfPDFBarcodeControl e TsgcAvaloniaPDFBarcodeControl li mostrano a schermo e li salvano in PNG o 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);
Tre controlli visualizzatore nativi, ciascuno con una vista miniature e una vista struttura (segnalibri). Le pagine sono disegnate dai renderer C# di sgcPDF, quindi non c'è alcun engine PDF nativo da distribuire con la tua applicazione.
TsgcPDFViewerControl, TsgcPDFThumbnailView e TsgcPDFOutlineView in esegece.sgcPDF.WinForms, per .NET Framework 4.7.2 e .NET 8 su Windows. Annotazioni interattive e risposte ai commenti, compilazione di moduli, box di pagina e uno strumento di misura.
TsgcWpfPDFViewer, TsgcWpfPDFThumbnailView e TsgcWpfPDFOutlineView in esegece.sgcPDF.Wpf, per .NET Framework 4.7.2 e .NET 8, 9 e 10 su Windows. Proprietà di dipendenza che puoi collegare, e pagine renderizzate su un thread in background in modo che l'interfaccia resti reattiva con file di grandi dimensioni.
TsgcAvaloniaPDFViewer, TsgcAvaloniaPDFThumbnailView e TsgcAvaloniaPDFOutlineView in esegece.sgcPDF.Avalonia, per .NET 8, 9 e 10 su Windows, Linux e macOS, con le funzionalità del visualizzatore WPF più lo zoom con pizzico.
Tutti e tre i visualizzatori offrono layout continuo, a pagina singola e a due pagine, adatta alla larghezza, adatta alla pagina e zoom personalizzato, zoom con selezione, selezione e copia del testo, ricerca con corrispondenze evidenziate, collegamenti, modifica delle annotazioni con note adesive, evidenziazioni, forme, inchiostro e timbri, e compilazione di moduli. Vedi la pagina del visualizzatore PDF per l'elenco completo delle funzionalità.
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");
}
}
<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>
Dal code behind, Viewer.LoadFromFile, Viewer.FindText e Viewer.PrintDialog aprono, cercano e stampano il documento. Ogni prodotto sgcUI usa il namespace XAML https://www.esegece.com/sgcui.
TsgcPDFRendererRaster renderizza una pagina in PNG o BMP in codice gestito. Funziona su ogni piattaforma su cui gira .NET, quindi un'API web o un servizio in background su un server Linux può creare miniature e anteprime. Su Windows, il pacchetto WinForms aggiunge il renderer GDI e l'esportazione delle pagine in immagini.
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");
}
TsgcPDFSignatureHandler firma un PDF con un certificato PFX e un campo firma visibile, e TsgcPDFSignatureVerifier controlla le firme di un file. In .NET, le firme usano System.Security.Cryptography. La firma con l'archivio certificati di Windows richiede 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");
}
Il pacchetto opzionale esegece.sgcPDF.sgcSign aggiunge TsgcPDFPAdESSigner, che firma in PAdES B-B, B-T, B-LT e B-LTA con qualsiasi provider di chiavi di sgcSign .NET, concesso in licenza separatamente.
TsgcPDFSignaturePad (WinForms), TsgcWpfPDFSignaturePad, che legge la pressione della penna dallo stilo, e TsgcAvaloniaPDFSignaturePad registrano una firma con il mouse, un dito o una penna.
Il pacchetto esegece.sgcPDF copre archiviazione, accessibilità e sicurezza, con una demo .NET compilata per ciascuna.
Output PDF/A-1b, PDF/A-2b e PDF/A-3b con font TrueType incorporati, PDF/A-4, e TsgcPDFAValidator per controllare un file. I file incorporati con relazioni PDF/A-3 trasportano fatture elettroniche Factur-X.
PDF con tag, con un albero di struttura e testo alternativo per le figure, output PDF/UA-1 (anche come PDF/A-2a) e PDF/UA-2, così gli screen reader seguono il documento.
Protezione con password con RC4-128, AES-128 o AES-256 e permessi, oppure crittografia per uno o più certificati dei destinatari.
TsgcPDFRedactor rimuove testo e aree dal contenuto, così i dati oscurati sono spariti dal file, non nascosti sotto un riquadro.
Crea AcroForm con campi di testo, caselle combinate, caselle di controllo e pulsanti, compilali da codice, ed esporta e importa i loro dati.
Box di pagina, imposizione con crocini di taglio, colori speciali, anteprima di sovrastampa e un output intent PDF/X. Vedi le funzionalità di prestampa.
È richiesto solo esegece.sgcPDF. Aggiungi il pacchetto WinForms, WPF o Avalonia per i controlli visualizzatore del tuo framework UI, e il pacchetto sgcSign per le firme PAdES. In Visual Studio, usa Manage NuGet Packages e cerca 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
Per l'edizione Community gratuita, usa gli stessi id di pacchetto con il suffisso .Community, per esempio dotnet add package esegece.sgcPDF.Community. In un progetto fai riferimento a una sola delle due edizioni. Vedi la guida all'installazione per .NET e le differenze dell'API .NET.
Il pacchetto core funziona ovunque giri .NET, compresi Windows, Linux e macOS. Il target netstandard2.0 raggiunge anche .NET Framework 4.6.2 e successivi e Mono. Le uniche dipendenze di terze parti sono System.Security.Cryptography.Pkcs e, su netstandard2.0 e net472, System.Memory.
| Pacchetto | Framework di destinazione | Sistemi operativi |
|---|---|---|
esegece.sgcPDF | netstandard2.0, net472, net6.0, net8.0, net9.0, net10.0 | Windows, Linux, macOS |
esegece.sgcPDF.WinForms | net472, net8.0-windows | Windows |
esegece.sgcPDF.Wpf | net472, net8.0-windows, net9.0-windows, net10.0-windows | Windows |
esegece.sgcPDF.Avalonia | net8.0, net9.0, net10.0, con Avalonia 12.0.0 o successivo | Windows, Linux, macOS |
esegece.sgcPDF.sgcSign | netstandard2.0, net472, net6.0, net8.0, net9.0, net10.0 | Dipende da esegece.sgcSign |
Le demo .NET includono 26 demo Windows Forms per creazione, codici a barre, moduli, crittografia, firme, PDF/A, PDF con tag, estrazione del testo e visualizzatore, più demo WPF e Avalonia del visualizzatore, del pad di firma, dell'editor di immagini e del controllo codice a barre. Scopri le demo .NET.
Entrambe le edizioni hanno le stesse funzionalità. Differiscono per la licenza, non per le capacità.
I pacchetti .Community sono gratuiti per uso commerciale e non commerciale da parte di privati e organizzazioni con ricavi lordi annui inferiori a 1 milione di EUR e non più di 5 sviluppatori. Mostrano un breve avviso all'avvio. Le organizzazioni che raggiungono o superano una delle due soglie hanno bisogno di una licenza Registered.
Rimuove l'avviso all'avvio e include la licenza commerciale. Licenze Single, Team e Site, ciascuna con codice sorgente completo, 1 anno di aggiornamenti e uno sconto di rinnovo dal 50% al 70%.
Prezzi di sgcPDF .NET →€249
Licenze Single, Team e Site disponibili.
esegece.sgcPDF e i pacchetti WinForms, WPF, Avalonia e sgcSignAggiungi il pacchetto NuGet esegece.sgcPDF (o esegece.sgcPDF.Community), crea un TsgcPDFDocument, aggiungi una pagina con AddPage, disegna su di essa testo, linee, immagini, tabelle e codici a barre e chiama SaveToFile, come nell'esempio di creazione di un PDF. Per convertire HTML con CSS, chiama HTMLToPDFFile di TsgcPDFHTMLRenderer.
La scelta migliore è la libreria che copre ciò che fa la tua applicazione. sgcPDF copre l'intero ciclo di vita del PDF in un'unica libreria .NET gestita: crea, modifica, unisci, estrai, visualizza in WinForms, WPF e Avalonia, renderizza in immagini, crittografa, firma, oscura e convalida PDF/A, senza DLL native e con il codice sorgente C# completo in ogni licenza. I pacchetti Community gratuiti hanno le stesse funzionalità, così puoi provare sgcPDF con i tuoi documenti prima di decidere.
Sì. TsgcWpfPDFViewer nel pacchetto esegece.sgcPDF.Wpf è un controllo WPF le cui pagine sono renderizzate dal renderer gestito di sgcPDF su un thread in background. Non viene distribuito nulla di nativo. Funziona su .NET Framework 4.7.2 e .NET 8, 9 e 10 su Windows. Per WinForms usa TsgcPDFViewerControl, e per Avalonia su Windows, Linux e macOS usa TsgcAvaloniaPDFViewer.
Carica il file in un TsgcPDFDocument e chiama RenderPageToPNG di TsgcPDFRendererRaster con la pagina e la dimensione in pixel, come nell'esempio da PDF a immagine. Il renderer raster scrive PNG o BMP e funziona su Windows, Linux e macOS, quindi gira anche sui server.
Sì. TsgcPDFSignatureHandler firma con un certificato PFX e un campo firma visibile, e TsgcPDFSignatureVerifier verifica le firme. Per PAdES B-B, B-T, B-LT e B-LTA, aggiungi esegece.sgcPDF.sgcSign: TsgcPDFPAdESSigner funziona con qualsiasi provider di chiavi di sgcSign .NET, concesso in licenza separatamente.
Sì. Ogni pacchetto NuGet di sgcPDF è disponibile anche come edizione Community gratuita con il suffisso .Community e le stesse funzionalità. È gratuita per privati e organizzazioni con ricavi lordi annui inferiori a 1 milione di EUR e non più di 5 sviluppatori, e mostra un breve avviso all'avvio. Le organizzazioni più grandi hanno bisogno di una licenza Registered, vedi i prezzi di sgcPDF.
La libreria è destinata a .NET Standard 2.0, .NET Framework 4.7.2, .NET 6, .NET 8, .NET 9 e .NET 10. Il visualizzatore WinForms è destinato a .NET Framework 4.7.2 e .NET 8 su Windows, il visualizzatore WPF a .NET Framework 4.7.2, .NET 8, .NET 9 e .NET 10 su Windows, e il visualizzatore Avalonia a .NET 8, .NET 9 e .NET 10.
Sì. Il pacchetto esegece.sgcPDF funziona ovunque giri .NET, compresi Linux e macOS, e il visualizzatore Avalonia funziona su Windows, Linux e macOS. I pacchetti WinForms e WPF sono per Windows. Fuori da Windows, carica i font TrueType da file con AddTrueTypeFontFromFile.