Procédure pas à pas : utilisation de l'utilitaire de test de ligne de commande
Mise à jour : novembre 2007
Cette procédure pas à pas vous montre comment exécuter des tests unitaires à partir d'une invite de ligne de commande et afficher ensuite les résultats.
Composants requis
Dans la procédure pas à pas intitulée Procédure pas à pas : création et exécution de tests unitaires, , exécutez les procédures suivantes : « Préparation de la procédure pas à pas », « Création d'un test unitaire » et « Exécution d'un test unitaire et correction de votre code ».
Le projet Woodgrove Bank. Consultez Test unitaire, exemple.
Utilisation de l'utilitaire de test en ligne de commande
Pour utiliser l'utilitaire de test en 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 2008, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.
L'invite de commandes s'ouvre dans le dossier : <lecteur>:\Program Files\Microsoft Visual Studio 9.0\VC
Modifiez le répertoire et accédez au dossier qui contient l'assembly construit à partir de votre projet de test.
Pour cela, basculez d'abord vers votre dossier de solution. Pour la solution Bank créée dans la procédure pas à pas préliminaire, il s'agit du dossier : <lecteur>:\Documents and Settings\<NomUtilisateur>\Mes documents\Visual Studio\Projects\Bank. Basculez ensuite vers le dossier de votre projet de test en tapant la commande suivante à l'invite de commandes :
cd TestProject1\bin\Debug
Ce dossier contient le projet de test que vous avez créé dans les procédures de création et d'exécution de tests unitaires. L'assembly du projet de test, TestProject1.dll, contient quelques tests unitaires seulement.
Remarque : Votre projet de code de production et votre projet de test produiront des assemblys distincts. Assurez-vous d'exécuter l'utilitaire en ligne de commande sur l'assembly du projet de test, et non sur l'assembly de votre projet de code de production.
MSTest.exe est un utilitaire en ligne de commande qui vous permet de démarrer et de contrôler l'exécution des tests. Vous pouvez afficher les choix offerts par MSTest.exe par le biais de ses options en tapant la commande suivante à l'invite :
MSTest /?
Utilisez l'utilitaire en ligne de commande pour tester l'application.
Tapez le texte suivant à l'invite de commandes :
MSTest /testcontainer:TestProject1.dll
Cette commande exécute les trois tests et retourne des résultats semblables aux suivants :
Loading TestProject1.dll...
Starting Execution...
Results Top Level Tests
-------- ------------------
Inconclusive TestProject1.BankAccountTest.CreditTest
Passed TestProject1.BankAccountTest.DebitTest
Passed TestProject1.BankAccountTest.FreezeAccountTest
2/3 test(s) Passed, 1 Inconclusive
Summary
----------
Test Run Inconclusive.
Inconclusive 1
Passed 2
-----------------
Total 3
Results file: <path>\<test run name>.trx
Run Configuration: Default Run Configuration
Remarque : Si vous terminez la procédure intitulée « Création et exécution d'un test unitaire pour une méthode privée » dans Procédure pas à pas : création et exécution de tests unitaires, cette commande affichera également des résultats pour le test unitaire GetAccountTestType.
Réexécutez les tests et enregistrez les résultats des tests dans un fichier spécifié.
Tapez le texte suivant à l'invite de commandes :
MSTest /testcontainer:TestProject1.dll /resultsfile:testResults1.trx
Cette commande exécute les trois tests et retourne les mêmes résultats qu'à l'étape précédente. Elle crée également un fichier nommé testResults1.trx et écrit les résultats des tests dans ce fichier, mis en forme pour un affichage dans une visionneuse XML telle que Microsoft Internet Explorer ou Microsoft Visual Studio. Si testResults1.trx existe déjà, MSTest.exe ne s'exécute pas et affiche une erreur signalant qu'un fichier avec ce nom existe déjà.
Remarque : Pour plus d'informations sur l'ensemble complet d'options que vous pouvez utiliser avec la commande MSTest, consultez Options de ligne de commande MSTest.exe.
(Facultatif) Affichez le fichier de résultats des tests. Tapez le texte suivant à l'invite de commandes :
testResults1.trx
Cela ouvre Internet Explorer et affiche les résultats des tests. Vous pouvez également ouvrir ce fichier dans l'environnement de développement intégré (IDE) de Visual Studio, comme suit : cliquez sur Fichier, pointez sur Ouvrir, puis cliquez sur Fichier ; dans la boîte de dialogue Ouvrir un fichier, ouvrez le dossier qui contient le fichier xml, puis double-cliquez sur testResults1.xml.
L'utilitaire en ligne de commande MSTest.exe est particulièrement utile pour automatiser des séries de tests ou pour exécuter des fichiers batch.
Voir aussi
Tâches
Comment : exécuter des tests à partir de la ligne de commande
Procédure pas à pas : création et exécution de tests unitaires