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 Package Manager, la console Package Manager Console o l'interfaccia della riga di comando .NET . Questa guida introduttiva illustra come usare il Package Manager NuGet e la console Package Manager per installare un pacchetto. Seguire i passaggi per la creazione di un progetto di Windows Presentation Foundation (WPF) 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 WPF.

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 WPF 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 Solution Explorer.

Aggiungere il pacchetto NuGet Newtonsoft.Json

Per installare un pacchetto NuGet in questa guida introduttiva, è possibile usare il Package Manager NuGet o la console di Package Manager. 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 Package Manager per installare il pacchetto Newtonsoft.Json in Visual Studio, seguire questa procedura:

  1. Selezionare Project>Gestisci pacchetti NuGet.

  2. Nella pagina NuGet Package Manager, 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 Package Manager 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 Package Manager in Visual Studio per installare il pacchetto Newtonsoft.Json, seguire questa procedura:

  1. In Visual Studio selezionare Tools>NuGet Package Manager>Package Manager Console.

  2. Nella parte superiore della finestra Package Manager 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 Package Manager, 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 Solution Explorer 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 Solution Explorer 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: