Questa pagina può contenere testo tradotto automaticamente.
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.
9.5.17664-dev Ne sono passati 14,820 Download totali di NuGet 4,998,853Installazione 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
9.5.17664-devTi 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
9.5.17664-devUtilizza 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
9.5.17664-devConsente 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
9.5.17664-devPuoi 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.