Condividi tramite


Guida introduttiva: Installare e usare un pacchetto NuGet in Visual Studio (solo Windows)

In questa guida introduttiva si userà Microsoft Visual Studio per installare e usare un pacchetto NuGet in un progetto. Un pacchetto NuGet contiene codice riutilizzabile che altri sviluppatori rendono disponibili per l'uso nei progetti.

È possibile installare un pacchetto NuGet in un progetto di Visual Studio usando NuGet Gestione pacchetti, la console Gestione pacchetti Console o l'interfaccia della riga di comando .NET . Questa guida introduttiva illustra come usare il Gestione pacchetti NuGet e la console Gestione pacchetti per installare un pacchetto. Seguire i passaggi per la creazione di un progetto di Windows Presentation Foundation (macchine virtuali Windows) che usa il pacchetto Newtonsoft.Json più diffuso. Lo stesso processo si applica a qualsiasi altro progetto .NET.

Questo articolo è destinato solo agli utenti di Windows. Se si usa Visual Studio per Mac, vedere 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 all'interno di Visual Studio come illustrato in questo articolo. Per altre informazioni, vedere Trovare e valutare i pacchetti NuGet per il progetto.

Prerequisiti

  • Installare Visual Studio 2026 con il carico di lavoro sviluppo per desktop .NET.

    È possibile installare gratuitamente l'edizione Community 2026 da visualstudio.microsoft.com oppure è possibile usare l'edizione Professional o Enterprise.

Creare un progetto

È possibile installare un pacchetto NuGet in qualsiasi progetto .NET se tale pacchetto supporta lo stesso framework di destinazione del progetto. Per questa guida introduttiva si crea un progetto di applicazione macchine virtuali Windows.

Seguire questa procedura:

  1. In Visual Studio selezionare File>New>Project/Solution.

  2. Nella finestra Crea un nuovo progetto passare alla casella di ricerca e immettere wpf. Nell'elenco risultante dei modelli di progetto selezionare il modello macchine virtuali Windows Application con tag C# e Windows e quindi selezionare Next.

  3. Nella finestra Configurare la nuova finestra project aggiornare facoltativamente i valori Project name e Nomesolution e quindi selezionare Next.

  4. Nella finestra Informazioni aggiuntive, in Framework selezionare .NET 10.0 (o la versione più recente) e 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 il 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 .

Gestore di pacchetti NuGet

Per usare il NuGet Gestione pacchetti per installare il pacchetto Newtonsoft.Json in Visual Studio, seguire questa procedura:

  1. Selezionare Project>Gestisci pacchetti NuGet.

  2. Nella pagina NuGet Gestione pacchetti, accanto a Origine del pacchetto, selezionare nuget.org.

  3. Passare alla scheda Sfoglia e cercare Newtonsoft.Json. Nell'elenco selezionare Newtonsoft.Json e quindi selezionare Installa.

    Screenshot del Gestione pacchetti NuGet. Il pacchetto Newtonsoft.Json è selezionato. Il riquadro dei dettagli visualizza i dati del pacchetto e include un pulsante Installa.

  4. Se viene richiesto di verificare l'installazione, selezionare Applica.

Console del Gestore di Pacchetti

In alternativa, per usare la console Gestione pacchetti in Visual Studio per installare il pacchetto Newtonsoft.Json, seguire questa procedura:

  1. In Visual Studio selezionare Tools>NuGet Gestione pacchetti>Gestione pacchetti Console.

  2. Nella parte superiore della finestra Gestione pacchetti Console verificare che il progetto Default elenco mostri il progetto in cui si vuole installare il pacchetto. Se nella soluzione è presente un singolo progetto, viene selezionato in modo predefinito.

    Screenshot della finestra della console di Gestione pacchetti, che contiene informazioni sulla versione e sulle licenze. L'elenco 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

Dopo aver installato un pacchetto NuGet, è possibile farvi riferimento nel codice usando l'istruzione using <namespace> , dove <namespace> è il nome del pacchetto in uso. Dopo aver creato un riferimento, è possibile chiamare il pacchetto tramite l'API.

Con il Newtonsoft.Json pacchetto nel progetto, è possibile chiamare il relativo JsonConvert.SerializeObject metodo. Per usare questo metodo per convertire un oggetto in una stringa leggibile, seguire questa procedura:

  1. In Esplora soluzioni aprire MainWindow.xaml e sostituire l'elemento <Grid> esistente con il codice seguente:

    <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. In Esplora soluzioni espandere il nodo MainWindow.xaml e quindi aprire il file MainWindow.xaml.cs. Inserire il codice seguente all'interno della MainWindow classe dopo il costruttore :

    public class Account
    {
        public string ID { get; set; }
        public decimal Balance { get; set; }
        public DateTime Created { get; set; }
    }
    
    private void Button_Click(object sender, RoutedEventArgs e)
    {
        Account account = new Account
        {
            ID = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
            Balance = 4389.21m,
            Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
        };
        string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
        TextBlock.Text = json;
    }
    
  3. Se MainWindow.xaml.cs non contiene la riga seguente, aggiungerla all'inizio del file:

    using Newtonsoft.Json;
    

    Senza questa riga, Visual Studio contrassegna l'oggetto JsonConvert con una linea rossa ondulata per indicare un errore.

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

    Viene visualizzata la finestra seguente:

    Screenshot della finestra MainWindow creata dall'app in Visual Studio. La finestra contiene un pulsante Click Me e il termine TextBlock.

  5. Selezionare Fai clic su Me. L'app aggiorna la finestra sostituendo l'oggetto TextBlock con testo JSON.

    Screenshot della finestra MainWindow in Visual Studio, che contiene un pulsante Click Me e codice JSON che elenca ID, Balance e Created values.

Per video sull'uso di NuGet per la gestione dei pacchetti, vedere .NET Package Management con NuGet per principianti e NuGet per principianti.

Per altre informazioni sull'installazione e la gestione dei pacchetti NuGet, vedere gli articoli seguenti:

Per altre informazioni su NuGet, vedere gli articoli seguenti: