Guida introduttiva: Installare e usare un pacchetto con l'interfaccia della riga di comando dotnet

  • Articolo

I pacchetti NuGet contengono codice binario compilato che gli sviluppatori rendono disponibili ad altri sviluppatori per l'uso nei progetti. Per altre informazioni, vedere Che cos'è NuGet. Questa guida introduttiva descrive come installare il pacchetto NuGet Newtonsoft.Json più diffuso in un progetto .NET usando il comando dotnet add package.

Si fa riferimento ai pacchetti installati nel codice con una using <namespace> direttiva, dove <namespace> è spesso il nome del pacchetto. È quindi possibile usare l'API del pacchetto nel progetto.

Suggerimento

Esplorare nuget.org/packages per trovare i pacchetti che è possibile riutilizzare nelle proprie applicazioni. È possibile cercare direttamente in https://nuget.orgoppure trovare e installare pacchetti da Visual Studio. Per altre informazioni, vedere Trovare e valutare i pacchetti NuGet per il progetto.

Prerequisiti

  • .NET SDK, che fornisce lo strumento da dotnet riga di comando. A partire da Visual Studio 2017, l'interfaccia della riga di comando dotnet viene installata automaticamente con qualsiasi carico di lavoro correlato a .NET o .NET Core.

Creare un progetto

È possibile installare pacchetti NuGet in un progetto .NET. Per questa procedura dettagliata, creare un semplice progetto console .NET usando l'interfaccia della riga di comando dotnet, come indicato di seguito:

  1. Creare una cartella denominata Nuget.Quickstart per il progetto.

  2. Aprire un prompt dei comandi e passare alla nuova cartella.

  3. Creare il progetto usando il comando seguente:

    dotnet new console

  4. Usare dotnet run per testare l'app. Verrà visualizzato l'output Hello, World!.

Aggiungere il pacchetto NuGet Newtonsoft.Json

  1. Usare il comando seguente per installare il pacchetto Newtonsoft.json.

    dotnet add package Newtonsoft.Json

  2. Al termine del comando, aprire il file Nuget.Quickstart.csproj in Visual Studio per visualizzare il riferimento al pacchetto NuGet aggiunto:

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

Usare l'API Newtonsoft.Json nell'app

  1. In Visual Studio aprire il file Program.cs e aggiungere la riga seguente all'inizio del file:

    using Newtonsoft.Json;

  2. Aggiungere il codice seguente per sostituire l'istruzione Console.WriteLine("Hello, World!"); :

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Salvare il file, quindi compilare ed eseguire l'app usando il dotnet run comando . L'output è la rappresentazione JSON dell'oggetto Account nel codice:

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

È stato installato e usato il primo pacchetto NuGet.

Trova altri video NuGet su Channel 9 e YouTube.

Passaggi successivi

Altre informazioni sull'installazione e l'uso di pacchetti NuGet con l'interfaccia della riga di comando dotnet:

Installare e usare i pacchetti usando l'interfaccia della riga di comando dotnet