Guida introduttiva: Installare e usare un pacchetto NuGet in Visual Studio (solo Windows)
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.
L'articolo riguarda solo gli utenti di Windows. Se stai usando Visual Studio per Mac, consulta Installare e usare un pacchetto in Visual Studio per Mac.
Suggerimento
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:<Grid Background="White"> <StackPanel VerticalAlignment="Center"> <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/> <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/> </StackPanel> </Grid>
Aprire il file MainWindow.xaml.cs nel nodo MainWindow.xaml e inserire il codice seguente all'interno della classe
MainWindow
dopo il costruttore:public class Account { public string Name { get; set; } public string Email { get; set; } public DateTime DOB { get; set; } } private void Button_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: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.
Video correlato
Vedere anche
Per altre informazioni su NuGet, vedere gli articoli seguenti:
- Che cos'è NuGet?
- flusso di lavoro per il consumo dei pacchetti
- Trovare e scegliere pacchetti
- Riferimenti ai pacchetti nei file di progetto
- Installare e usare un pacchetto usando l'interfaccia della riga di comando di .NET.
- pacchetto Newtonsoft.Json
Passaggi successivi
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.