Comment : regrouper et exécuter des tests automatisés à l'aide de catégories de test
Les catégories de test vous permettent d'exécuter des groupes de tests selon leurs catégories assignées sans qu'il soit nécessaire de maintenir des listes de tests. Une catégorie de test est un attribut de méthode de test que vous pouvez assigner à un ou plusieurs tests à l'aide de l'Explorateur de tests.
Vous pouvez utiliser des opérateurs logiques avec les catégories de test pour exécuter des tests à partir de plusieurs catégories ou pour limiter les tests que vous exécutez à des tests qui appartiennent à plusieurs catégories. Les catégories de test sont également faciles à ajouter lors de la création de vos méthodes de test et vous n'avez pas besoin de gérer des listes de tests après la création.
Les procédures suivantes décrivent comment créer, assigner, filtrer et exécuter des catégories de test avec vos tests.
Création et assignation de catégories de test
Pour créer une nouvelle catégorie de test
Dans le menu Test, cliquez sur Fenêtres, puis sélectionnez Affichage des tests.
La fenêtre Affichage des tests s'affiche.
Sélectionnez un test.
Dans le volet de propriétés du test sélectionné, cliquez sur le bouton de sélection (...) dans la colonne Catégories de test.
La fenêtre Catégorie de test s'affiche.
Dans le champ Ajouter une nouvelle catégorie, tapez le nom de votre nouvelle catégorie de test.
Cliquez sur Ajouter.
Cliquez sur OK.
La nouvelle catégorie de test est assignée à votre test et sera disponible pour les autres tests dans la fenêtre Affichage des tests.
Pour assigner des catégories de test à un test
Dans le menu Test, cliquez sur Fenêtres, puis sélectionnez Affichage des tests.
La fenêtre Affichage des tests s'affiche.
Sélectionnez un test.
Dans le volet de propriétés du test sélectionné, cliquez sur le bouton de sélection (...) dans la colonne Catégories de test.
La fenêtre Catégorie de test s'affiche.
Dans le volet Catégories disponibles, sélectionnez la catégorie de test que vous voulez assigner au test. Pour sélectionner plusieurs catégories de test, appuyez sur Maj + M.
Cliquez sur >>.
Les catégories que vous avez sélectionnées s'afficheront dorénavant dans le volet Catégories assignées.
Cliquez sur OK.
Pour ajouter manuellement des catégories de test à un test
Dans votre projet de test dans l'Explorateur de solutions, ouvrez le fichier qui contient le test unitaire, puis recherchez la méthode de test unitaire à modifier.
- ou -
Dans Affichage des tests, double-cliquez sur le test unitaire et faites défiler jusqu'à la méthode de test unitaire.
Directement au-dessus de la déclaration de méthode de test, ajoutez un attribut (TestCategory ()) pour chaque catégorie de test à assigner au test. Séparez chaque attribut avec une virgule.
Ajoutez le nom de catégorie entre parenthèses à chaque attribut (TestCategory ()). L'exemple suivant illustre une méthode à laquelle sont assignées trois catégories de test nommées "Nightly", "Weekly", et "ShoppingCart" :
[TestCategory("Nightly"), TestCategory("Weekly"), TestCategory("ShoppingCart"), TestMethod()] public Void DebitTest() { }
Suppression de catégories de test
Pour supprimer des catégories de test d'un test
Dans le menu Test, cliquez sur Fenêtres, puis sélectionnez Affichage des tests.
La fenêtre Affichage des tests s'affiche.
Sélectionnez un test.
Dans le volet de propriétés du test sélectionné, cliquez sur le bouton de sélection (...) dans la colonne Catégories de test.
La fenêtre Catégorie de test s'affiche.
Dans le volet Catégories assignées, sélectionnez la catégorie de test que vous voulez supprimer du test. Pour sélectionner plusieurs catégories de test, appuyez sur Maj + M.
Cliquez sur <<.
Les catégories que vous avez sélectionnées s'afficheront dorénavant dans le volet Catégories disponibles.
Cliquez sur OK.
Filtrage de tests par catégories
Pour trier les tests par catégories de test dans la fenêtre Affichage des tests
Dans le menu Test, cliquez sur Fenêtres, puis sélectionnez Affichage des tests.
La fenêtre Affichage des tests s'affiche.
Dans la barre d'outils de la fenêtre Affichage des tests, cliquez sur la flèche dans la liste déroulante de gauche et sélectionnez Catégories de test.
La valeur par défaut est (Toutes les colonnes).
Dans la zone de texte de filtrage, tapez le nom de la catégorie que vous voulez filtrer et appuyez sur ENTRÉE.
Les tests associés à la catégorie que vous avez spécifiée s'affichent dans l'Affichage des tests.
La valeur par défaut est <Effacer le filtre>.
(Facultatif) Cliquez sur les en-têtes de colonnes Nom du test ou Projet pour trier la liste.
Exécution des tests par catégories
Pour exécuter un test à l'aide de catégories dans Affichage des tests
Dans le menu Test, cliquez sur Fenêtres, puis sélectionnez Affichage des tests.
La fenêtre Affichage des tests s'affiche.
Dans la barre d'outils de la fenêtre Affichage des tests, cliquez sur la flèche dans la liste déroulante de gauche et sélectionnez Catégories de test.
La valeur par défaut est (Toutes les colonnes).
Dans la zone de texte de filtrage, tapez le nom de la catégorie que vous voulez filtrer et appuyez sur ENTRÉE.
Les tests associés à la catégorie que vous avez spécifiée s'affichent dans Affichage des tests.
La valeur par défaut est <Effacer le filtre>.
Notes
Vous ne pouvez pas utiliser d'opérateurs logiques avec des catégories de test lorsque vous filtrez les tests que vous voulez exécuter à partir de l'Affichage des tests. Vous ne pouvez le faire que lorsque vous exécutez des tests à partir de la ligne de commande.
(Facultatif) Cliquez sur les en-têtes de colonnes Nom du test ou Projet pour trier la liste.
Cliquez sur les tests de la catégorie de test que vous souhaitez exécuter.
Utilisez MAJ + clic ou CTRL + clic pour sélectionner des tests supplémentaires.
Cliquez sur Exécuter la sélection dans la barre d'outils.
Lorsque vous exécutez des tests à partir de la ligne de commande, vous pouvez également utiliser les opérateurs logiques & (AND), | (OR) et ! (NOT) pour sélectionner les tests à exécuter en fonction des catégories assignées aux tests.
Pour exécuter un test à l'aide de catégories de la ligne de commande
Ouvrez une invite de commandes Visual Studio.
Pour cela, cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft Visual Studio 2010, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 10.0.
Par défaut, l'invite de commandes Visual Studio s'ouvre au dossier suivant :
<lettre du lecteur>:\Program Files\Microsoft Visual Studio 10.0\VC
Notes
Pour modifier le dossier auquel la fenêtre d'invite de commandes s'ouvre par défaut, cliquez sur Démarrer, pointez sur Microsoft Visual Studio 2010, sur Visual Studio Tools, cliquez avec le bouton droit sur Invite de commandes de Visual Studio 10.0, puis cliquez sur Propriétés. Dans la boîte de dialogue Propriétés de Invite de commandes de Visual Studio 10.0, vous pouvez modifier le chemin d'accès au dossier par défaut dans la zone Démarrer dans.
Remplacez le répertoire par l'emplacement de votre dossier de solution où se trouve le conteneur de test. Il s'agit en général du fichier .dll du projet de test. Ou, lorsque vous exécutez l'étape 3 du programme MSTest.exe, spécifiez un chemin d'accès complet ou relatif pour le conteneur de test.
Pour identifier votre dossier de solution, identifiez d'abord le dossier de projets Visual Studio. Pour cela, cliquez sur Options dans le menu Outils dans Visual Studio, puis cliquez sur Projets et solutions. Sous Emplacement des projets Visual Studio, un chemin d'accès tel que le suivant est affiché :
<drive letter>:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects
Votre dossier de solution est en général un enfant de ce dossier de projets, tel que le dossier Bank dans l'exemple suivant :
<drive letter>:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\Bank
Pour exécuter des tests qui sont assignés à la fois à la catégorie "Nightly" et à la catégorie "ShoppingCart", exécutez le programme MSTest.exe en utilisant les commutateurs /testcontainer et /category:
mstest /testcontainer:MyTestprojectName.dll /category:"Nightly&ShoppingCart"
Les résultats et le résumé s'affichent dans la fenêtre d'invite de commandes.
Notes
Vous pouvez utiliser AND ou OR dans votre expression pour sélectionner des catégories de test, mais pas les deux à la fois dans la même expression.
Pour plus d'informations, consultez Comment : exécuter des tests automatisés à partir de la ligne de commande à l'aide de MSTest et Options de ligne de commande MSTest.exe.