Questa pagina può contenere testo tradotto automaticamente.

Iniziare

Questo articolo spiega alcune nozioni di base per iniziare a elaborare i file PDF nelle applicazioni WinForms, console o ASP.NET con la libreria Docotic.Pdf.

Iniziare con 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

  1. Scarica l'ultima versione della libreria Docotic.Pdf dal nostro sito. La libreria è distribuita come pacchetto ZIP.
    Il pacchetto ZIP contiene due versioni della libreria:
    • versione per .NET 4.0 e framework successivi
    • versione per .NET Standard 2.0 e framework successivi.

    Il pacchetto ZIP contiene anche tutti i progetti di esempio e il file con il contratto di licenza.

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

Esecuzione del codice di esempio

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

Lo stesso codice di esempio può essere clonato o scaricato dal nostro repository di esempi su GitHub.

Si prega di prendersi del tempo per rivedere i campioni. Dovrebbe aiutarti ad aggiungere funzionalità di elaborazione PDF alla tua applicazione.

Utilizzo di Docotic.Pdf nell'applicazione WinForms, console o ASP.NET

  1. Apri l'IDE di Visual Studio. Crea un nuovo progetto o aprine uno esistente.

  2. Apri la finestra di dialogo Aggiungi riferimento e aggiungi un riferimento a BitMiracle.Docotic.Pdf.dll.

    • L'elenco delle estensioni conterrà l'assembly BitMiracle.Docotic.Pdf se hai aggiunto la libreria a GAC
    • In alternativa, puoi accedere alla posizione in cui hai estratto il pacchetto ZIP e selezionare la DLL da lì.

Aggiunta di Docotic.Pdf utilizzando la finestra di dialogo Aggiungi riferimento

Tieni presente che puoi aggiungere un riferimento NuGet a BitMiracle.Docotic.Pdf invece di fare riferimento manualmente alla sua DLL.

Per accedere a metodi e proprietà che forniscono interoperabilità con i tipi dello spazio dei nomi System.Drawing e GDI+, dovresti aggiungere un riferimento alla DLL dell'estensione BitMiracle.Docotic.Pdf.Gdi. È possibile trovare la DLL nel pacchetto ZIP o installare il pacchetto BitMiracle.Docotic.Pdf.Gdi da NuGet.

Per convertire HTML in PDF (o SVG in PDF) dovresti aggiungere un riferimento alla DLL dell'estensione BitMiracle.Docotic.Pdf.HtmlToPdf. La DLL è anche nel pacchetto ZIP ma consigliamo di installare il pacchetto BitMiracle.Docotic.Pdf.HtmlToPdf da NuGet invece di aggiungere manualmente la DLL.

Per creare documenti PDF utilizzando il motore di layout, aggiungere il riferimento alla DLL dell'estensione BitMiracle.Docotic.Pdf.Layout. Il motore suddivide automaticamente il contenuto in pagine e fornisce supporto per intestazioni e piè di pagina, tabelle e paragrafi. Puoi trovare la DLL nel pacchetto ZIP ma ti consigliamo di installare il pacchetto BitMiracle.Docotic.Pdf.Layout da NuGet invece di aggiungere manualmente la DLL.

  1. Per evitare di digitare riferimenti completi alla dll, è meglio aggiungere la seguente istruzione using a quelle già esistenti nel file sorgente in C#
    using BitMiracle.Docotic.Pdf;
    

    In VB.NET usa questo:

    Imports BitMiracle.Docotic.Pdf
    
  2. In un progetto C#, aggiungi il metodo seguente 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,
     });
    }
    

Per un progetto VB.NET utilizzare questo

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
  1. Chiama il metodo helloPdf() dal tuo codice. Questo dovrebbe produrre il file hello.pdf e aprirlo nel visualizzatore PDF predefinito.

ciao.pdf in un visualizzatore PDF predefinito

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 la documentazione che accompagna la libreria e a rivedere gli esempi. Potresti anche voler dare un'occhiata al blog Bit Miracle.