Condividi tramite

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.

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:

  1. In Visual Studio selezionare File>Nuovo progetto>.

  2. 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.

  3. Nella finestra Configura il nuovo progetto aggiornare facoltativamente il nome del progetto e il nome della soluzione e quindi selezionare Avanti.

  4. 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:

  1. Selezionare Project>Gestire NuGet Packages.

  2. Nella pagina gestione pacchetti NuGet scegliere nuget.org come origine del pacchetto .

  3. Nella scheda Sfoglia cercare Newtonsoft.Json, selezionare Newtonsoft.Json nell'elenco e quindi selezionare Installa.

    Screenshot che mostra la finestra Gestione pacchetti NuGet con il pacchetto Newtonsoft.Json selezionato.

  4. 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:

  1. Da Visual Studio, selezionare Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. 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.

    Screenshot che mostra la finestra Console gestione pacchetti con il progetto predefinito evidenziato.

  3. 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:

  1. 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>

  2. 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;
}

  3. 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;

  4. Per compilare ed eseguire l'app, premere F5 o selezionare Debug>Avvia debug.

    Viene visualizzata la finestra seguente:

    Screenshot che mostra l'output iniziale dell'app WPF.

  5. Selezionare il pulsante Fare clic su Me per visualizzare il contenuto dell'oggetto TextBlock sostituito con il testo JSON.

    Screenshot che mostra l'output dell'app WPF dopo aver selezionato il pulsante.

Vedere anche

Per altre informazioni su NuGet, vedere gli articoli seguenti:

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.

Installare e gestire i pacchetti usando Gestione pacchetti NuGet

Installare e gestire i pacchetti tramite la console di Gestione pacchetti