Procédure pas à pas : utilisation de l'utilitaire de test de ligne de commande

  • Article

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

Utilisation de l'utilitaire de test en ligne de commande

Pour utiliser l'utilitaire de test en ligne de commande

  1. 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

  2. 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.

  3. 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 /?

  4. 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.

  5. 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.

  6. (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

Concepts

Options de ligne de commande MSTest.exe