Découvrir les projets et les solutions avec Visual Basic

Dans cet article d’introduction, nous allons explorer le processus de création d’une solution et d’un projet dans Visual Studio. Une solution est un conteneur servant à organiser un ou plusieurs projets de code associés, par exemple un projet de bibliothèque de classes et un projet de test correspondant. Nous allons examiner les propriétés d’un projet et certains des fichiers associés. Nous allons également créer une référence d’un projet vers un autre.

Conseil

Si vous n’avez pas encore installé Visual Studio, accédez à la page Téléchargements Visual Studio pour l’installer gratuitement.

Nous allons créer une solution et un projet de toutes pièces pour vous aider à bien comprendre le concept de projet. En règle générale, quand vous créez un projet dans Visual Studio, il vous suffit le plus souvent d’utiliser certains des différents modèles de projet proposés par Visual Studio.

Notes

Le développement d’applications dans Visual Studio peut se faire sans solutions ni projets. Vous pouvez aussi simplement ouvrir un dossier qui contient du code et commencer à écrire du code, générer des builds et déboguer le code. Par exemple, si vous clonez un dépôt GitHub, il est possible qu’il ne contienne pas de solutions et projets Visual Studio. Pour plus d’informations, consultez Développer du code dans Visual Studio sans projets ni solutions.

Solutions et projets

Malgré son nom, une solution n’est pas une « réponse ». Il s’agit simplement d’un conteneur dans lequel Visual Studio organise un ou plusieurs projets associés. Quand vous ouvrez une solution dans Visual Studio, tous les projets que contient la solution sont chargés automatiquement.

Créer une solution

Nous allons commencer notre exploration en créant une solution vide. Une fois que vous serez familiarisé avec Visual Studio, vous n’aurez sans doute pas souvent l’occasion de créer des solutions vides. Quand vous créez un projet, Visual Studio crée automatiquement une solution pour héberger le projet (s’il n’y a pas d’autre solution déjà ouverte).

1. Ouvrez Visual Studio.

2. Dans la fenêtre de démarrage, choisissez Créer un projet.

3. Sur la page Créer un projet, entrez nouvelle solution dans la zone de recherche, sélectionnez le modèle Nouvelle solution, puis choisissez Suivant.

   

4. Nommez la solution QuickSolution, puis choisissez Créer.

   Une solution s’affiche dans l’Explorateur de solutions sur le côté droit de la fenêtre Visual Studio. L’Explorateur de solutions vous sera sans doute souvent utile pour parcourir le contenu de vos projets.

Ajouter un projet

Nous allons maintenant ajouter notre premier projet à la solution. Nous allons démarrer avec un projet vide et y ajouter les éléments nécessaires.

1. Dans le menu contextuel (clic droit) de Solution 'QuickSolution' dans l’Explorateur de solutions, choisissez Ajouter>Nouveau projet.

   Une boîte de dialogue s’ouvre en indiquant Ajouter un nouveau projet.

2. Dans la zone de recherche en haut, entrez le texte vide, puis sélectionnez Visual Basic dans la liste déroulante Tous les langages.

3. Sélectionnez le modèle Projet vide (.NET Framework), puis choisissez Suivant.

4. Nommez le projet QuickDate, puis choisissez Créer.

   Un projet nommé QuickDate s’affiche en dessous de la solution dans l’Explorateur de solutions. Il contient un seul fichier appelé App.config.

   Notes

   Si vous ne voyez pas le modèle Projet vide (.NET Framework), installez la charge de travail Visual Studio de développement d’applications de bureau .NET. Visual Studio utilise une 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 effectuez. Pour installer une nouvelle charge de travail quand vous créez un projet, il vous suffit simplement de choisir le lien Installer plus d’outils et de fonctionnalités sous le texte indiquant Vous n’arrivez pas à trouver ce que vous cherchez ?. Une fois Visual Studio Installer lancé, choisissez la charge de travail Développement .NET Desktop, puis cliquez sur le bouton Modifier.

   

Ajouter un élément au projet

Nous avons un projet vide. Ajoutons un fichier de code.

1. Dans le menu contextuel (clic droit) du projet QuickDate dans l’Explorateur de solutions, choisissez Ajouter>Nouvel élément.

   La boîte de dialogue Ajouter un nouvel élément s’ouvre.

2. Développez Éléments communs, puis choisissez Code. Dans le volet central, choisissez le modèle d’élément Classe. Nommez la classe Calendar, puis choisissez le bouton Ajouter.

   Un fichier nommé Calendar.vb est ajouté au projet. Le .vb à la fin correspond à l’extension de fichier attribuée aux fichiers de code Visual Basic. Le fichier s’affiche dans la hiérarchie de projets Visual de l’Explorateur de solutions, et son contenu s’ouvre dans l’éditeur.

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

   Class Calendar
       Public Shared Function GetCurrentDate() As Date
           Return DateTime.Now.Date
       End Function
   End Class
   

   La classe Calendar contient une seule fonction, GetCurrentDate, qui retourne la date actuelle.

4. Ouvrez les propriétés du projet en double-cliquant sur Mon projet dans l’Explorateur de solutions. Sur l’onglet Application , remplacez Type d’application par Bibliothèque de classes. Cette étape est nécessaire pour générer correctement le projet.

5. Générez le projet en cliquant avec le bouton droit sur QuickDate dans l’Explorateur de solutions et en choisissant Build. Un message de réussite de la build devrait apparaître dans la fenêtre Sortie.

Ajouter un deuxième projet

Les solutions contiennent souvent plusieurs projets, qui font référence les uns aux autres. Les différents projets d’une solution peuvent être des bibliothèques de classes, des applications exécutables, des projets de test unitaire ou des sites web.

Nous allons ajouter un projet de test unitaire à notre solution. Cette fois, nous allons démarrer avec un modèle de projet. Nous n’avons donc pas à ajouter un fichier de code supplémentaire au projet.

1. Dans le menu contextuel (clic droit) de Solution 'QuickSolution' dans l’Explorateur de solutions, choisissez Ajouter>Nouveau projet.

2. Dans la boîte de dialogue Ajouter un nouveau projet, dans la zone de recherche en haut, entrez le texte test unitaire, puis sélectionnez Visual Basic dans la liste déroulante Tous les langages.

3. Choisissez le modèle de projet Projet de test unitaire (.NET Framework), puis Suivant.

4. Nommez le projet QuickTest, puis choisissez Créer.

   Un deuxième projet est ajouté à l’Explorateur de solutions et un fichier nommé UnitTest1.vb s’ouvre dans l’éditeur.

Ajouter une référence au projet

Nous allons utiliser le nouveau projet de test unitaire pour tester notre méthode dans le projet QuickDate. Nous devons donc ajouter une référence à ce projet. La référence crée une dépendance de build entre les deux projets. Cela signifie que QuickDate est généré avant QuickTest quand vous générez la solution.

1. Choisissez le nœud Références dans le projet QuickTest et, dans le menu contextuel (clic droit), choisissez Ajouter une référence.

   

   La boîte de dialogue Gestionnaire de références s’ouvre.

2. Dans le volet gauche, développez Projets et choisissez Solution. Dans le volet central, cochez la case à côté de QuickDate, puis choisissez le bouton OK.

   Une référence au projet QuickDate est ajoutée.

Ajouter le code de test

1. Nous allons maintenant ajouter le code de test dans le fichier de code Visual Basic. Remplacez le contenu du fichier UnitTest1.vb par le code suivant.

   <TestClass()> Public Class UnitTest1
   
       <TestMethod()> Public Sub TestGetCurrentDate()
           Assert.AreEqual(Date.Now.Date, QuickDate.Calendar.GetCurrentDate())
       End Sub
   
   End Class
   

   Vous voyez une ligne ondulée rouge s’afficher sous une partie du code. Pour résoudre cette erreur, nous devons référencer le projet de test comme assembly friend dans le projet QuickDate.

2. Retournez dans le projet QuickDate, ouvrez le fichier Calendar.vb s’il n’est pas ouvert, puis ajoutez l’instruction Imports et l’attribut InternalsVisibleToAttribute suivants pour résoudre l’erreur dans le projet de test.

   Imports System.Runtime.CompilerServices
   
   <Assembly: InternalsVisibleTo("QuickTest")>
   

   Le fichier de code doit ressembler à ceci :

   

Propriétés d’un projet

Dans le fichier Calendar.vb, la ligne contenant l’attribut InternalsVisibleToAttribute fait référence au nom de l’assembly (nom de fichier) du projet QuickTest. Le nom de l’assembly n’est pas toujours identique au nom du projet. Pour connaître le nom de l’assembly d’un projet, ouvrez les propriétés du projet.

1. Dans l’Explorateur de solutions, sélectionnez le projet QuickTest. Dans le menu contextuel (clic droit), sélectionnez Propriétés, ou appuyez simplement sur Alt+Entrée. (Vous pouvez également double-cliquer sur Mon Projet dans l’Explorateur de solutions.)

   Les pages de propriétés du projet s’ouvrent dans l’onglet Application. Elles contiennent différents paramètres du projet. Notez que le nom de l’assembly du projet QuickTest est bien « QuickTest ». Vous pouvez modifier le nom de l’assembly à cet emplacement si vous le souhaitez. Quand vous générez le projet de test, le nom du fichier binaire obtenu a le nouveau nom choisi à la place de QuickTest.dll.

   

2. Explorez les autres onglets des pages de propriétés du projet, tels que les onglets Compiler et Paramètres. Ces onglets sont différents pour différents types de projets.

(Facultatif) Exécuter le test

Si vous souhaitez vérifier que votre test unitaire fonctionne correctement, choisissez Test>Exécuter Tous les tests dans la barre de menus. Une fenêtre intitulée Explorateur de tests s’ouvre. Vérifiez que le résultat du test TestGetCurrentDate est correct.

Astuce

Si l’Explorateur de tests ne s’ouvre pas automatiquement, ouvrez-le en choisissant Tester>Windows>Explorateur de tests dans la barre de menus.

Étapes suivantes

Pour explorer davantage Visual Studio, vous pouvez créer une application en suivant l’un des tutoriels Visual Basic.

Voir aussi

• Créer des projets et des solutions
• Gérer les propriétés des projets et des solutions
• Gérer les références dans un projet
• Développer du code dans Visual Studio sans projets ni solutions
• Vue d’ensemble de l’IDE de Visual Studio