Partager via

Démarrage rapide : Installer et utiliser un package avec l’interface CLI dotnet

Les packages NuGet contiennent du code binaire compilé que les développeurs mettent à la disposition d’autres développeurs à utiliser dans leurs projets. Pour plus d’informations, consultez Présentation de NuGet. Ce guide de démarrage rapide explique comment installer le package NuGet Newtonsoft.Json populaire dans un projet .NET à l’aide de la commande dotnet add package .

Vous faites référence aux packages installés dans du code avec une using <namespace> directive, où <namespace> est souvent le nom du package. Vous pouvez ensuite utiliser l’API du package dans votre projet.

Conseil / Astuce

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

Conditions préalables

  • Kit de développement logiciel (SDK) .NET, qui fournit l’outil dotnet en ligne de commande. À compter de Visual Studio 2017, l’interface CLI dotnet s’installe automatiquement avec toutes 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 ajoutez la ligne suivante en haut du fichier :

    using Newtonsoft.Json;

  2. Ajoutez le code suivant pour remplacer l’instruction 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. Enregistrez le fichier, puis générez et exécutez l’application à l’aide de la dotnet run commande. 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 !

Trouvez d’autres vidéos NuGet sur Channel 9 et YouTube.

Étapes suivantes

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