Iniziare

Tradotto da Bit Miracle. Articolo originale di Sergey Bobrovsky

Aggiornato il 27 febbraio 2026

Questo articolo illustra alcune nozioni di base per iniziare a elaborare i file PDF nelle applicazioni .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity e HoloLense 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.

Se non conosci NuGet Manager, fai riferimento a questo articolo di avvio rapido.

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, individua il percorso in cui hai estratto il pacchetto ZIP e seleziona la DLL da lì.

Esecuzione del codice di esempio

Gli esempi di codice per Docotic.Pdf si trovano nella cartella Samples del pacchetto ZIP. Apri il file di soluzione SamplesCSharp se desideri utilizzare codice di esempio scritto in linguaggio C#. Per una versione VB.NET, aprire il file della soluzione SamplesVB.NET.

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

Ti preghiamo di dedicare del tempo alla revisione degli esempi di codice. Dovrebbe aiutarti ad aggiungere funzionalità di elaborazione PDF alla tua applicazione.

Utilizzo di Docotic.Pdf nel tuo progetto .NET

Per evitare di digitare nomi completi dei tipi forniti dalla libreria, è meglio aggiungere la seguente direttiva using al 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 dell'applicazione:

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

    string outputName = "hello.pdf";
    // nell'applicazione ASP.NET utilizzare 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, utilizzare 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"
    ' nell'applicazione ASP.NET utilizzare 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 produrre il file ciao.pdf e aprirlo nel visualizzatore PDF predefinito.

Componenti aggiuntivi

Puoi estendere le funzionalità principali con componenti aggiuntivi gratuiti.

Componente aggiuntivo HtmlToPdf

Utilizza il componente aggiuntivo HtmlToPdf per convertire HTML in PDF. Il componente aggiuntivo utilizza Google Chrome e il suo motore di rendering Blink, quindi supporta HTML5, CSS3 e JavaScript in modo ottimale. Puoi generare PDF da HTML, SVG, WEBP e altri formati web utilizzando il componente aggiuntivo.

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

Componente aggiuntivo Layout

Utilizza il componente aggiuntivo Layout per generare PDF da elementi di layout strutturati. Puoi creare documenti a partire da blocchi di testo, immagini, tabelle, intestazioni, piè di pagina, contenitori e, facoltativamente, componenti personalizzati riutilizzabili, e la fluida API Layout si occuperà di tutto.

Invece di posizionare gli elementi a coordinate fisse, è possibile descrivere interi documenti tramite codice utilizzando un'API pulita ed espressiva che adatta il layout sia al contenuto che alle dimensioni della pagina. Il motore di layout gestisce quindi automaticamente la paginazione, l'annidamento e le strutture complesse. Questo semplifica la produzione di qualsiasi cosa, dalle semplici pagine ai sofisticati report PDF.

Per maggiori informazioni sulla generazione di PDF in .NET con l'API Layout, leggere l'articolo che ne spiega in dettaglio 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. È possibile installare il pacchetto BitMiracle.Docotic.Pdf.Gdi da NuGet. Oppure aggiungi manualmente i riferimenti alle 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. Installare il pacchetto BitMiracle.Docotic.Pdf.Logging da NuGet. Oppure aggiungi manualmente i riferimenti alle 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 utilizzando la libreria Docotic.Pdf. Questo è solo l'inizio, però. Ti invitiamo a leggere le funzionalità della libreria e a rivedere gli esempi di codice. Potresti anche voler dare un'occhiata al blog Bit Miracle.