Présentation des projets et des solutions

Dans ce tutoriel, vous allez explorer ce qu’il signifie pour créer une solution et un projet dans Visual Studio. Une solution est un conteneur pour organiser un ou plusieurs projets de code connexes, comme un projet de bibliothèque de classes et un projet de test correspondant. Vous créez une référence d’un projet à un autre dans une solution. Ce tutoriel décrit également les propriétés d’un projet et certains des fichiers qu’il peut contenir.

En tant qu’exercice pour comprendre le concept d’un projet, vous créez une solution et un projet à partir de zéro. En règle générale, vous utiliseriez des modèles de projet Visual Studio pour créer de nouveaux projets.

Dans ce tutoriel, vous allez apprendre à :

• Ajouter un élément au projet
• Ajouter un deuxième projet
• Ajouter une référence de projet
• Ajouter du code de test
• Afficher les propriétés du projet

Conditions préalables

• Si vous n'avez pas Visual Studio, allez sur Téléchargements de Visual Studio pour l'installer gratuitement.

Solutions et projets

Dans Visual Studio, une solution n’est pas une réponse . Une solution est simplement un conteneur que Visual Studio utilise pour organiser un ou plusieurs projets connexes. Lorsque vous ouvrez une solution, Visual Studio charge automatiquement tous les projets que la solution contient.

Remarque

Le développement d’applications dans Visual Studio ne nécessite pas de solutions et de projets. Vous pouvez simplement ouvrir un dossier qui contient du code et démarrer le codage, la génération et le débogage. Par exemple, un dépôt GitHub cloné peut ne pas contenir de projets et de solutions Visual Studio. Pour plus d’informations, consultez Développer du code dans Visual Studio sans projets ni solutions.

Créer une solution

Démarrez votre exploration en créant une solution vide. Après avoir appris à connaître Visual Studio, vous ne créerez probablement pas souvent de solutions vides. Lorsque vous créez un projet, Visual Studio crée automatiquement une solution pour le projet, sauf si une solution est déjà ouverte.

1. Ouvrez Visual Studio, puis, dans la fenêtre de démarrage, sélectionnez Créer un projet.

2. Dans la page Créer un projet, tapez solution vide dans la zone de recherche, sélectionnez le modèle Solution vide, puis Suivant.

   

   Conseil

   Si plusieurs charges de travail sont installées, le modèle Solution Vide peut ne pas apparaître en haut de votre liste de résultats de recherche. Essayez de faire défiler l’écran jusqu’à Autres résultats en fonction de votre recherche pour trouver le modèle.

3. Dans la page Configurer votre nouveau projet, nommez la solution QuickSolution, puis sélectionnez Créer.

   La solution QuickSolution s’affiche dans l'Explorateur de solutions à droite de la fenêtre Visual Studio. Vous utiliserez Explorateur de solutions souvent pour parcourir le contenu de vos projets.

Ajouter un projet

Ajoutez maintenant votre premier projet à la solution. Commencez par un projet vide et ajoutez les éléments dont vous avez besoin.

1. Dans l’Explorateur de Solutions, faites un clic droit sur la Solution « QuickSolution ». Dans le menu contextuel, sélectionnez Ajouter>nouveau projet.

2. Dans la page Ajouter un nouveau projet, tapez vide dans la zone de recherche en haut, puis sélectionnez C# sous Tous les langages.

3. Sélectionnez le modèle de projet vide (.NET Framework) C# , puis sélectionnez Prochain.

   Note

   Visual Studio utilise l’installation basée sur la charge de travail pour installer uniquement les composants dont vous avez besoin pour le type de développement que vous faites. Si vous ne voyez pas le modèle Projet Vide (.NET Framework), installez la charge de travail de développement pour bureau .NET dans Visual Studio.

   Un moyen simple d'installer une nouvelle charge de travail lorsque vous créez un projet consiste à sélectionner le lien Installer d'autres outils et fonctionnalités sous le texte qui indique Ne trouvez-vous pas ce que vous recherchez ?. Dans Visual Studio Installer, sélectionnez la charge de travail Développement .NET Desktop, puis sélectionnez Modifier.

   

4. Dans la page Configurer votre nouveau projet, nommez le projet QuickDate, puis sélectionnez Créer.

   Le projet QuickDate s’affiche sous la solution dans l’Explorateur de solutions. Le projet contient un nœud Références et un seul fichier nommé App.config.

Ajouter un élément au projet

Ajoutez un fichier de code à votre projet vide.

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet QuickDate. Dans le menu contextuel, sélectionnez Ajouter>nouvel élément.

   La boîte de dialogue Ajouter un nouvel élément s’ouvre. Sélectionnez Afficher tous les modèles si la boîte de dialogue s’ouvre en mode compact.

2. Développez Éléments Visual C#, puis sélectionnez Code. Dans le volet central, sélectionnez le modèle d’élément classe. Sous Nom, saisissez Calendrier, puis sélectionnez Ajouter.

   Visual Studio ajoute un fichier nommé Calendar.cs au projet. Le .cs à la fin est l’extension de fichier pour les fichiers de code C#. Le fichier Calendar.cs s’affiche dans l’Explorateur de solutions hiérarchie de projet visuel, et le fichier s’ouvre dans l’éditeur.

3. Remplacez le contenu du fichier Calendar.cs par le code suivant :

   using System;
   
   namespace QuickDate
   {
       internal class Calendar
       {
           static void Main(string[] args)
           {
               DateTime now = GetCurrentDate();
               Console.WriteLine($"Today's date is {now}");
               Console.ReadLine();
           }
   
           internal static DateTime GetCurrentDate()
           {
               return DateTime.Now.Date;
           }
       }
   }
   

   Vous n’avez pas besoin de comprendre tout ce que fait le code. Exécutez l’application en appuyant sur Ctrl+F5. L'application imprime la date du jour sur la fenêtre de console ou de sortie standard. Fermez ensuite la fenêtre de console.

Ajouter un deuxième projet

Les solutions contiennent généralement plusieurs projets, et ces projets font souvent référence les uns aux autres. Certains projets d’une solution peuvent être des bibliothèques de classes, certains peuvent être des applications exécutables, et certains peuvent être des projets de test unitaire ou des sites web.

Pour ajouter un projet de test unitaire à votre solution, commencez à partir d’un modèle de projet afin que vous n’ayez pas à ajouter un autre fichier de code au projet.

1. Dans l’Explorateur de Solutions, faites un clic droit sur la Solution « QuickSolution ». Dans le menu contextuel, sélectionnez Ajouter>nouveau projet.

2. Dans la boîte de dialogue Ajouter un nouveau projet, tapez test unitaire dans la zone de recherche en haut, puis sélectionnez C# sous Tous les langages.

3. Sélectionnez le modèle de projet de test unitaire C# (.NET Framework), puis sélectionnez Suivant.

4. Dans la page Configurer votre nouveau projet, nommez le projet QuickTest, puis sélectionnez Créer.

   Visual Studio ajoute le projet QuickTest à Explorateur de solutions, et le fichier UnitTest1.cs s’ouvre dans l’éditeur.

   

Ajouter une référence de projet

Pour utiliser le nouveau projet de test unitaire pour tester votre méthode dans le projet QuickDate, vous devez ajouter une référence à QuickDate au projet QuickTest. L’ajout de la référence crée une dépendance de build entre les deux projets. Lorsque vous générez la solution, QuickDate est construit avant QuickTest.

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud Références du projet QuickTest. Dans le menu contextuel, sélectionnez Ajouter une référence.

2. Dans la boîte de dialogue Gestionnaire de références, sélectionnez Projets. Dans le volet central, cochez la case en regard de QuickDate, puis sélectionnez OK.

   Une référence au projet QuickDate apparaît sous le projet QuickTest dans l’Explorateur de solutions .

   

Ajouter du code de test

1. Ajoutez maintenant du code de test au fichier de code de test C#. Remplacez le contenu de UnitTest1.cs par le code suivant :

   using System;
   using Microsoft.VisualStudio.TestTools.UnitTesting;
   
   namespace QuickTest
   {
       [TestClass]
       public class UnitTest1
       {
           [TestMethod]
           public void TestGetCurrentDate()
           {
               Assert.AreEqual(DateTime.Now.Date, QuickDate.Calendar.GetCurrentDate());
           }
       }
   }
   

   Une ligne ondulée rouge apparaît sous une partie du code. Vous pouvez résoudre cette erreur en définissant le projet de test en tant que assembly friend du projet QuickDate.

2. Dans le fichier Calendar.cs, ajoutez l’instruction using et l’attribut InternalsVisibleToAttribute suivants en haut du fichier pour résoudre l’erreur dans le projet de test.

   using System.Runtime.CompilerServices;
   
   [assembly: InternalsVisibleTo("QuickTest")]
   

   Le code Calendar.cs doit ressembler à cette capture d’écran :

   

Exécuter le test unitaire

Pour vérifier que votre test unitaire fonctionne, dans la barre de menus, choisissez Test>Exécuter tous les tests. La fenêtre de l’Explorateur de tests s’ouvre et vous devez voir que le test TestGetCurrentDate est réussi.

Conseil

Vous pouvez également ouvrir Explorateur de tests en choisissant >Explorateur de tests à partir de la barre de menus.

Propriétés du projet

La ligne du fichier Calendar.cs qui contient l’attribut InternalsVisibleToAttribute fait référence au nom de l’assembly ou au nom de fichier du projet QuickTest. Le nom de l’assembly peut ne pas toujours être identique au nom du projet. Pour rechercher le nom d’assembly d’un projet, utilisez les propriétés du projet. Les pages de propriétés contiennent différents paramètres pour le projet.

1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet QuickTest et sélectionnez Propriétés, ou sélectionnez le projet, puis appuyez sur Alt+Entrée.

   Les pages de propriétés pour le projet s’ouvrent sous l’onglet application. Le nom de l’assembly du projet QuickTest est en effet QuickTest.

   Si vous le souhaitez, vous pouvez modifier le nom ici. Lorsque vous générez le projet de test, le nom du fichier binaire résultant passe de QuickTest.dll à <NewName>.dll.

   

2. Explorez d’autres onglets des pages de propriétés du projet, par exemple Générer et Déboguer. Ces onglets sont différents pour différents types de projets.

Contenu connexe

• créer, utiliser et supprimer des projets et des solutions Visual Studio
• Développer du code dans Visual Studio sans projets ni solutions
• Gérer les propriétés de projet et de solution
• Gérer les références dans un projet