Guida introduttiva: Installare e usare un pacchetto con l'interfaccia della riga di comando di dotnetQuickstart: Install and use a package using the dotnet CLI

I pacchetti NuGet contengono codice riutilizzabile che altri sviluppatori rendono disponibile per l'uso nei progetti.NuGet packages contain reusable code that other developers make available to you for use in your projects. Vedere Che cos'è NuGet? per le informazioni di base.See What is NuGet? for background. I pacchetti vengono installati in un progetto .NET Core usando il comando dotnet add package, come descritto in questo articolo per il famoso pacchetto Newtonsoft.Json.Packages are installed into a .NET Core project using the dotnet add package command as described in this article for the popular Newtonsoft.Json package.

Al termine dell'installazione, fare riferimento al pacchetto nel codice con using <namespace>, dove <spazio dei nomi> è specifico per il pacchetto in uso.Once installed, refer to the package in code with using <namespace> where <namespace> is specific to the package you're using. È quindi possibile usare l'API del pacchetto.You can then use the package's API.

Suggerimento

Iniziare con nuget.org: le ricerche in nuget.org sono il modo in cui gli sviluppatori di .NET individuano in genere componenti che possono riutilizzare nelle loro applicazioni.Start with nuget.org: Browsing nuget.org is how .NET developers typically find components they can reuse in their own applications. È possibile eseguire una ricerca direttamente in nuget.org o trovare e installare pacchetti all'interno di Visual Studio, come illustrato in questo articolo.You can search nuget.org directly or find and install packages within Visual Studio as shown in this article.

PrerequisitiPrerequisites

  • .NET Core SDK, che fornisce lo strumento da riga di comando dotnet.The .NET Core SDK, which provides the dotnet command-line tool. A partire da Visual Studio 2017, l'interfaccia della riga di comando di dotnet viene installata automaticamente con qualsiasi carico di lavoro .NET Core correlato.Starting in Visual Studio 2017, the dotnet CLI is automatically installed with any .NET Core related workloads.

Creare un progettoCreate a project

I pacchetti NuGet possono essere installati in un progetto .NET di qualche tipo.NuGet packages can be installed into a .NET project of some kind. Per questa procedura dettagliata creare un progetto console .NET Core semplice come segue:For this walkthrough, create a simple .NET Core console project as follows:

  1. Creare una cartella per il progetto.Create a folder for the project.

  2. Aprire un prompt dei comandi e passare alla nuova cartella.Open a command prompt and switch to the new folder.

  3. Creare il progetto usando il comando seguente:Create the project using the following command:

    dotnet new console
    
  4. Usare dotnet run per verificare che l'app sia stata creata correttamente.Use dotnet run to test that the app has been created properly.

Aggiungere il pacchetto NuGet Newtonsoft.JsonAdd the Newtonsoft.Json NuGet package

  1. Usare il comando seguente per installare il pacchetto Newtonsoft.json.Use the following command to install the Newtonsoft.json package:

    dotnet add package Newtonsoft.Json
    
  2. Al termine dell'esecuzione del comando, aprire il file .csproj per vedere il riferimento aggiunto:After the command completes, open the .csproj file to see the added reference:

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

Usare l'API Newtonsoft.Json nell'appUse the Newtonsoft.Json API in the app

  1. Aprire il file Program.cs e aggiungere la riga seguente all'inizio del file:Open the Program.cs file and add the following line at the top of the file:

    using Newtonsoft.Json;
    
  2. Aggiungere il codice seguente prima della riga class Program:Add the following code before the class Program line:

    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }
    
  3. Sostituire la funzione Main con il codice seguente:Replace the Main function with the following:

    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);
    }
    
  4. Compilare ed eseguire l'app usando il comando dotnet run.Build and run the app by using the dotnet run command. L'output deve essere la rappresentazione JSON dell'oggetto Account nel codice:The output should be the JSON representation of the Account object in the code:

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

Passaggi successiviNext steps

È stato installato e usato il primo pacchetto NuGet.Congratulations on installing and using your first NuGet package!

Per esplorare in modo più approfondito ciò che NuGet può offrire, selezionare i collegamenti seguenti.To explore more that NuGet has to offer, select the links below.