Guida introduttiva: Installare e usare un pacchetto NuGet in Visual Studio (solo Windows)
Articolo
Un pacchetto NuGet contiene codice riutilizzabile che altri sviluppatori hanno reso disponibile per l'uso nei tuoi progetti. È possibile installare un pacchetto NuGet in un progetto di Microsoft Visual Studio usando Gestione pacchetti NuGet , la console di Gestione pacchetti o l'interfaccia della riga di comando di .NET . Questo articolo illustra come creare un progetto Windows Presentation Foundation (WPF) con il pacchetto di Newtonsoft.Json più diffuso. Lo stesso processo si applica a qualsiasi altro progetto .NET o .NET Core.
Dopo aver installato un pacchetto NuGet, è possibile crearvi un riferimento nel codice con l'istruzione using <namespace>, dove <spazio dei nomi> è il nome del pacchetto in uso. Dopo aver creato un riferimento, è possibile chiamare il pacchetto tramite l'API.
Per trovare un pacchetto NuGet, iniziare con nuget.org. L'esplorazione di nuget.org è il modo in cui gli sviluppatori .NET trovano in genere componenti che possono riutilizzare nelle proprie applicazioni. È possibile eseguire una ricerca di nuget.org direttamente o trovare e installare pacchetti in Visual Studio, come illustrato in questo articolo. Per altre informazioni, vedere Trovare e valutare i pacchetti NuGet.
Prerequisiti
Installare Visual Studio 2022 per Windows con il workload di sviluppo di applicazioni desktop .NET.
È possibile installare gratuitamente l'edizione Community 2022 da visualstudio.microsoft.comoppure usare Professional o Enterprise Edition.
Creare un progetto
È possibile installare un pacchetto NuGet in qualsiasi progetto .NET se tale pacchetto supporta lo stesso framework di destinazione del progetto. Tuttavia, per questa guida introduttiva si creerà un progetto di applicazione Windows Presentation Foundation (WPF).
Seguire questa procedura:
In Visual Studio selezionare File>Nuovo progetto>.
Nella finestra Crea un nuovo progetto immettere WPF nella casella di ricerca e selezionare C# e Windows negli elenchi a discesa. Nell'elenco risultante dei modelli di progetto selezionare applicazione WPFe quindi selezionare Avanti.
Nella finestra Configura il nuovo progetto aggiornare facoltativamente il nome del progetto e il nome della soluzione e quindi selezionare Avanti.
Nella finestra Informazioni aggiuntive selezionare .NET 6.0 (o versione più recente) per Frameworke quindi selezionare Crea.
Visual Studio crea il progetto e viene visualizzato in Esplora Soluzioni .
Aggiungere il pacchetto NuGet Newtonsoft.Json
Per installare un pacchetto NuGet in questa guida introduttiva, è possibile usare Gestione pacchetti NuGet o la console di Gestione pacchetti. A seconda del formato del progetto, l'installazione di un pacchetto NuGet registra la dipendenza nel file di progetto o in un file packages.config. Per ulteriori informazioni, vedere il workflow del consumo dei pacchetti .
Gestione pacchetti NuGet
Per usare la gestione pacchetti NuGet per installare il pacchetto Newtonsoft.Json in Visual Studio, seguire questa procedura:
Selezionare Project>Gestire NuGet Packages.
Nella pagina gestione pacchetti NuGet scegliere nuget.org come origine del pacchetto .
Nella scheda Sfoglia cercare Newtonsoft.Json, selezionare Newtonsoft.Json nell'elenco e quindi selezionare Installa.
Se viene richiesto di verificare l'installazione, selezionare OK.
Console di Gestione pacchetti
In alternativa, per usare la Console di Gestione pacchetti in Visual Studio per installare il pacchetto Newtonsoft.Json, seguire questa procedura:
Da Visual Studio, selezionare Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.
Dopo aver aperto il riquadro console di Gestione pacchetti, verificare che l'elenco a discesa progetto predefinito mostri il progetto in cui si desidera installare il pacchetto. Se nella soluzione è presente un singolo progetto, viene selezionato in modo predefinito.
Al prompt della console immettere il comando Install-Package Newtonsoft.Json. Per altre informazioni su questo comando, vedere Install-Package.
La finestra della console mostra l'output del comando. Gli errori indicano in genere che il pacchetto non è compatibile con il framework di destinazione del progetto.
Usare l'API Newtonsoft.Json nell'app
Con il pacchetto Newtonsoft.Json nel progetto, chiamare il relativo metodo JsonConvert.SerializeObject per convertire un oggetto in una stringa leggibile:
Da Esplora soluzioni, apri MainWindow.xaml e sostituisci l'elemento <Grid> esistente con il seguente codice:
Aprire il file MainWindow.xaml.cs nel nodo MainWindow.xaml e inserire il codice seguente all'interno della classe MainWindow dopo il costruttore:
C#
publicclassAccount
{
publicstring Name { get; set; }
publicstring Email { get; set; }
public DateTime DOB { get; set; }
}
privatevoidButton_Click(object sender, RoutedEventArgs e)
{
Account account = new Account
{
Name = "John Doe",
Email = "john@microsoft.com",
DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
};
string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
TextBlock.Text = json;
}
Per evitare un errore per l'oggetto JsonConvert nel codice (verrà visualizzata una riga ondulata rossa), aggiungere l'istruzione seguente all'inizio del file di codice:
C#
using Newtonsoft.Json;
Per compilare ed eseguire l'app, premere F5 o selezionare Debug>Avvia debug.
Viene visualizzata la finestra seguente:
Selezionare il pulsante Fare clic su Me per visualizzare il contenuto dell'oggetto TextBlock sostituito con il testo JSON.
Congratulazioni per l'installazione e l'uso del primo pacchetto NuGet. Passare all'articolo successivo per altre informazioni sull'installazione e la gestione dei pacchetti NuGet.
Come creare un progetto .NET, con informazioni su come aggiungere pacchetti e gestire le dipendenze dei pacchetti nel progetto. Usare l'interfaccia della riga di comando di .NET Core e il registro NuGet per aggiungere librerie e strumenti alle applicazioni C# tramite Visual Studio Code.
NuGet è lo strumento di gestione dei pacchetti per le piattaforme di sviluppo Microsoft, incluso .NET. Gli strumenti client NuGet offrono la possibilità di creare e utilizzare i pacchetti.
Questo articolo descrive un problema a causa del quale Microsoft basato su NuGet Gestione pacchetti 1.5 o versione successiva non è installato in un computer e fornisce una risoluzione.
Questo documento illustra come includere un pacchetto NuGet in un progetto usando Visual Studio per Mac. Illustra come trovare e scaricare un pacchetto e introdurre le funzionalità di integrazione dell'IDE.
Informazioni su come installare e usare gli strumenti dell'interfaccia della riga di comando del client dotnet e NuGet e lo strumento Gestione pacchetti per Visual Studio.