Introduzione

Tradotto da Bit Miracle. Articolo originale di Sergey Bobrovsky

Aggiornato il 23 giugno 2026

Questo articolo illustra alcune nozioni di base per iniziare a elaborare file PDF nelle tue applicazioni .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity e HoloLens con la libreria Docotic.Pdf.

Installazione della libreria Docotic.Pdf

Installazione da NuGet

Il modo più semplice per iniziare è installare il pacchetto BitMiracle.Docotic.Pdf da NuGet.

Fai riferimento a questo articolo introduttivo se non hai familiarità con NuGet Manager.

Installazione manuale

Scarica l'ultima versione della libreria Docotic.Pdf dal nostro sito. Distribuiamo la libreria come pacchetto ZIP. Il pacchetto contiene la libreria Docotic.Pdf, tutti i progetti di codice di esempio, i componenti aggiuntivi della libreria e i contratti di licenza.

Estrai il pacchetto ZIP scaricato in una posizione a tua scelta.

In Visual Studio, apri la finestra di dialogo Aggiungi riferimento, cerca la posizione in cui hai estratto il pacchetto ZIP e scegli il DLL da lì.

Esecuzione del codice di esempio

Il codice di esempio per Docotic.Pdf si trova nella cartella Samples del pacchetto ZIP. Apri il file di soluzione SamplesCSharp se vuoi usare il codice di esempio scritto in C#. Per una versione VB.NET, apri il file di soluzione SamplesVB.NET.

Puoi clonare o scaricare gli stessi esempi di codice dal nostro repository del codice di esempio su GitHub.

Ti consigliamo di esaminare il codice di esempio. Dovrebbe aiutarti ad aggiungere funzionalità di elaborazione PDF alla tua applicazione.

Uso di Docotic.Pdf nel tuo progetto .NET

Per evitare di digitare i nomi completamente qualificati dei tipi forniti dalla libreria, è meglio aggiungere la seguente direttiva using al tuo file sorgente C#:

using BitMiracle.Docotic.Pdf;

In VB.NET usa questo:

Imports BitMiracle.Docotic.Pdf

In un progetto C#, aggiungi il seguente metodo al codice sorgente della tua applicazione:

private static void helloPdf()
{
    // sostituisci string.Empty con la tua chiave di licenza
    BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);

    string outputName = "hello.pdf";
    // in un'applicazione ASP.NET usa invece la seguente riga:
    // string outputName = Server.MapPath("hello.pdf");

    using (PdfDocument pdf = new PdfDocument())
    {
        // disegna "Hello world" sulla prima pagina
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // apre il documento salvato nel visualizzatore PDF predefinito
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
        FileName = outputName,
        UseShellExecute = true,
    });
}

In un progetto VB.NET, usa il seguente codice:

Private Shared Sub helloPdf()
    ' sostituisci string.Empty con la tua chiave di licenza
    BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)

    Dim outputName As String = "hello.pdf"
    ' in un'applicazione ASP.NET usa invece la seguente riga:
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' disegna "Hello world" sulla prima pagina
        Dim firstPage As PdfPage = pdf.Pages(0)
        firstPage.Canvas.DrawString(20, 20, "Hello world!")

        pdf.Save(outputName)
    End Using

    ' apre il documento salvato nel visualizzatore PDF predefinito
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub

Chiama il metodo helloPdf dal tuo codice. Questo dovrebbe generare il file hello.pdf e aprirlo nel tuo visualizzatore PDF predefinito.

Componenti aggiuntivi

Puoi estendere la funzionalità principale con componenti aggiuntivi gratuiti.

Componente aggiuntivo HtmlToPdf

Usa il componente aggiuntivo HtmlToPdf per convertire HTML in PDF. Il componente aggiuntivo usa Google Chrome e il suo motore di rendering Blink, quindi il supporto per HTML5, CSS3 e JavaScript è ottimo. Puoi generare PDF da HTML, SVG, WEBP e altri formati web usando il componente aggiuntivo.

Per ulteriori informazioni sull'API HTML to PDF fornita dal componente aggiuntivo, leggi la panoramica delle sue funzionalità. L'articolo spiega come installare il componente aggiuntivo da NuGet o manualmente. Include anche codice di esempio.

Componente aggiuntivo Layout

Usa il componente aggiuntivo Layout per generare PDF da elementi di layout strutturati. Componi i documenti con segmenti di testo, immagini, tabelle, intestazioni, piè di pagina, contenitori e, opzionalmente, componenti personalizzati riutilizzabili, e la Layout API fluente organizza tutto per te.

Anziché posizionare gli elementi a coordinate fisse, descrivi interi documenti nel codice usando un'API pulita ed espressiva che adatta il layout sia al contenuto sia alla dimensione della pagina. Il motore di impaginazione gestisce poi automaticamente la suddivisione in pagine, il nesting e le strutture complesse. Questo rende semplice produrre di tutto, da pagine semplici a report PDF sofisticati.

Per ulteriori informazioni su come generare PDF in .NET con la Layout API, leggi l'articolo che ne spiega in profondità le funzionalità e include istruzioni di installazione e codice di esempio.

Componente aggiuntivo Gdi

Consente di stampare documenti PDF o disegnare PDF su System.Drawing.Graphics. Puoi installare il pacchetto BitMiracle.Docotic.Pdf.Gdi da NuGet. In alternativa, aggiungi manualmente riferimenti ai seguenti DLL dal pacchetto ZIP:

• BitMiracle.Docotic.Pdf.dll
• Gdi add-on/BitMiracle.Docotic.Pdf.Gdi.dll

Componente aggiuntivo Logging

Puoi usarlo per registrare informazioni sulla struttura interna dei documenti PDF. Installa il pacchetto BitMiracle.Docotic.Pdf.Logging da NuGet. In alternativa, aggiungi manualmente riferimenti ai seguenti DLL dal pacchetto ZIP:

• BitMiracle.Docotic.Pdf.dll
• Logging add-on/BitMiracle.Docotic.Pdf.Logging.dll
• Logging add-on/Microsoft.Extensions.Logging.Abstractions.dll

Conclusione

Ora dovresti essere in grado di sviluppare funzionalità relative ai PDF nelle tue applicazioni usando la libreria Docotic.Pdf. Tuttavia, questo è solo l'inizio. Ti invitiamo a leggere le funzionalità della libreria e a esaminare il codice di esempio. Potresti anche voler consultare il blog di Bit Miracle.