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

Dans ce guide de démarrage rapide, vous installez le package NuGet Newtonsoft.Json populaire dans un projet .NET. 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 Une présentation de NuGet.

Pour installer le package, vous utilisez la commande dotnet package add , qui fait partie de l’interface de ligne de commande dotnet (CLI).

Conditions préalables

Kit de développement logiciel (SDK) .NET, qui fournit l’interface CLI dotnet. Dans Visual Studio, l’interface CLI dotnet s’installe automatiquement avec toutes les charges de travail associées à .NET.

Création d’un projet

Vous pouvez installer des packages NuGet dans un projet .NET. Pour ce guide de démarrage rapide, procédez comme suit pour créer un projet de console .NET de base à l’aide de l’interface CLI dotnet :

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

2. Ouvrez une fenêtre d’invite de commandes et accédez au 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 commande écrit la sortie suivante à l’écran : Hello, World!.

Ajouter le package NuGet Newtonsoft.Json

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

   dotnet package add Newtonsoft.Json
   

   Si vous utilisez .NET 9 ou une version antérieure, utilisez plutôt la forme avec le verbe en premier :

   dotnet add package Newtonsoft.Json
   

2. Une fois la commande terminée, ouvrez le fichier Nuget.Quickstart.csproj dans Visual Studio ou dans un éditeur de texte. Recherchez la référence du package NuGet ajoutée :

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

Utiliser l’API Newtonsoft.Json dans l’application

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

1. Dans Visual Studio ou dans un éditeur de texte, ouvrez le fichier Program.cs. 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? Id { get; set; }
           public decimal Balance { get; set; }
           public DateTime Created { get; set; }
       }
       internal class Program
       {
           static void Main(string[] args)
           {
               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, 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 :

   {
     "Id": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
     "Balance": 4389.21,
     "Created": "2026-04-16T00:00:00Z"
   }
   

Vidéos connexes

Pour plus d’informations sur l’utilisation de NuGet pour la gestion des packages, consultez .NET Gestion des packages avec NuGet pour débutants et NuGet pour les débutants.

Contenu connexe

Pour en savoir plus sur l’installation et l’utilisation de packages NuGet à l’aide de l’interface CLI dotnet, consultez les articles suivants :

• Installer et gérer des packages NuGet avec l’interface CLI dotnet
• flux de travail de consommation de paquet
• Rechercher et évaluer des packages NuGet pour votre projet
• PackageReference dans les fichiers projet