Démarrage rapide : Installer et utiliser un package à l’aide de l’interface CLI dotnet

  • Article

Les packages NuGet contiennent du code binaire compilé que des développeurs mettent à la disposition d’autres développeurs afin qu’ils puissent l’utiliser dans leurs projets. Pour plus d’informations, consultez Qu’est-ce que NuGet. Ce guide de démarrage rapide explique comment installer le célèbre package NuGet Newtonsoft.Json dans un projet .NET à l’aide de la commande dotnet add package.

Vous faites référence aux packages installés dans du code à l’aide d’une directive using <namespace>, où <namespace> est souvent le nom du package. Vous pourrez alors utiliser l’API du package dans le projet.

Conseil

Parcourez nuget.org/packages pour rechercher des packages que vous pouvez réutiliser dans vos propres applications. Vous pouvez effectuer des recherches directement dans https://nuget.org, ou rechercher et installer des packages dans Visual Studio. Pour plus d’information, consultez Rechercher et évaluer des packages NuGet pour votre projet.

Prérequis

  • Le kit SDK .NET, qui fournit l’outil en ligne de commande dotnet. À partir de Visual Studio 2017, l’interface CLI dotnet est installée automatiquement avec les charges de travail associées à .NET ou .NET Core.

Création d’un projet

Vous pouvez installer des packages NuGet dans un projet .NET. Pour cette procédure pas à pas, créez un projet de console .NET simple à l’aide de l’interface CLI dotnet comme suit :

  1. Créez un dossier nommé Nuget.Quickstart pour le projet.

  2. Ouvrez une invite de commandes et basculez vers le nouveau dossier.

  3. Créez le projet à l’aide de la commande suivante :

    dotnet new console

  4. Utilisez dotnet run pour tester l’application. La sortie Hello, World! doit s’afficher.

Ajouter le package NuGet Newtonsoft.Json

  1. Utilisez la commande suivante pour installer le package Newtonsoft.json :

    dotnet add package Newtonsoft.Json

  2. Une fois la commande terminée, ouvrez le fichier Nuget.Quickstart.csproj dans Visual Studio pour afficher la référence de package NuGet ajoutée :

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

Utiliser l’API Newtonsoft.Json dans l’application

  1. Dans Visual Studio, ouvrez le fichier Program.cs et spécifiez au début de celui-ci la ligne suivante :

    using Newtonsoft.Json;

  2. Ajoutez le code suivant à la place de l’intsruction 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. Enregistrer le fichier, puis générez et exécutez l’application à l’aide de la commande dotnet run. La sortie est la représentation JSON de l’objet Account dans le code :

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

Félicitations pour l’installation et l’utilisation de votre premier package NuGet !

Retrouvez d’autres vidéos à propos de NuGet sur Channel 9 et YouTube.

Étapes suivantes

Pour en savoir plus sur l’installation et l’utilisation de packages NuGet avec l’interface CLI dotnet :

Installer et utiliser des packages à l’aide de l’interface CLI dotnet