Iniziare

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

Ti consente di convertire HTML in PDF (o SVG/WEBP in PDF). È possibile installare il pacchetto BitMiracle.Docotic.Pdf.HtmlToPdf da NuGet. Oppure aggiungi manualmente i riferimenti alle seguenti DLL dal pacchetto ZIP:

• BitMiracle.Docotic.Pdf.dll
• HtmlToPdf add-on/BitMiracle.Docotic.Pdf.HtmlToPdf.dll
• HtmlToPdf add-on/Microsoft.Bcl.AsyncInterfaces.dll

Componente aggiuntivo Layout

Utilizza il componente aggiuntivo per generare documenti PDF da un progetto definito nel codice. Utilizza elementi costitutivi come pagine, contenitori, immagini, paragrafi di testo e simili per creare PDF di qualsiasi complessità.

Il componente aggiuntivo di layout divide automaticamente il contenuto in pagine e fornisce supporto per intestazioni e piè di pagina, tabelle e paragrafi. Installare il pacchetto BitMiracle.Docotic.Pdf.Layout da NuGet. Oppure aggiungi manualmente i riferimenti alle seguenti DLL dal pacchetto ZIP:

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

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.