Procédure pas à pas : création et exécution d'un test générique

Article
08/21/2008

Mise à jour : novembre 2007

Dans cette procédure pas à pas, vous allez inclure un fichier exécutable dans un wrapper en tant que test générique, puis exécuter le test. Vous allez commencer par créer un fichier exécutable à l'aide de l'exemple de code existant. Vous allez ensuite créer un test générique et ajouter le fichier exécutable à ce test générique. Vous terminerez en exécutant le test.

Remarque :
Pour plus d'informations sur les tests génériques, consultez Vue d'ensemble des tests génériques.

Dans cette procédure pas à pas, vous allez effectuer les tâches suivantes :

création d'un programme, autrement dit un fichier exécutable, à encapsuler comme test générique. Ce programme représente un outil de test tiers qui produit des résultats de réussite ou d'échec comme sortie ou valeur de retour à l'achèvement du programme ; Consultez Préparation de la procédure pas à pas.
Création d'un test générique.
Exécution du test générique.
Passez des arguments de ligne de commande lorsque vous exécutez le test générique. Pour plus d'informations, consultez Exécution du test générique.
Déploiement d'un fichier lorsque vous exécutez le test générique.

Composants requis

Vous devez créer le fichier exécutable EvenOdd.exe. Pour ce faire, utilisez le code source dans l'Exemple de test générique et appliquez les étapes de la procédure suivante intitulée « Préparation de la procédure pas à pas ».

Préparation de la procédure pas à pas

Pour préparer la procédure pas à pas

Créez un projet pour une nouvelle application console Visual C#. Dans le champ Nom de la boîte de dialogue Nouveau projet, tapez EvenOdd, puis cliquez sur OK.

La solution EvenOdd est affichée dans l'Explorateur de solutions. Elle contient un projet nommé EvenOdd.
Dans le projet EvenOdd, ouvrez le fichier de code source Program.cs.
Remplacez le code du fichier Program.cs par le code de l'Exemple de test générique.
Générez la solution.

Cela crée le programme que vous encapsulerez pour créer un test générique.

Création d'un test générique

Pour créer un test générique

Cliquez avec le bouton droit sur la solution EvenOdd, pointez sur Ajouter, puis cliquez sur Nouveau projet.

La boîte de dialogue Ajouterun nouveau projet s'affiche.
Dans la boîte de dialogue Ajouter un nouveau projet, développez Visual C#, puis cliquez sur Test.
Dans le volet Modèles, cliquez sur Projet de test, puis cliquez sur OK. Acceptez le nom par défaut, par exemple ProjetTest1.
Cliquez avec le bouton droit sur le projet de test, pointez sur Ajouter, puis cliquez sur Test générique.

Le modèle pour un test générique est ajouté à votre projet de test et affiché dans la fenêtre de modification principale. Un nom par défaut est attribué au nouveau test générique, par exemple GenericTest1.GenericTest, et le test s'affiche dans l'Explorateur de solutions.

Sous Spécifiez un programme existant (test, atelier de test ou adaptateur de test) à utiliser comme test générique, indiquez le chemin d'accès et le nom de fichier du fichier EvenOdd.exe.

Remarque :
Pour déterminer ce chemin d'accès, cliquez sur Options dans le menu Outils, puis cliquez sur Projets et solutions. Le chemin d'accès de la solution EvenOdd est affiché sous Emplacement des projets Visual Studio. La solution EvenOdd contient un dossier destiné au projet EvenOdd. Sous le dossier du projet EvenOdd, EvenOdd.exe réside sous bin\Debug\.

Cette désignation sera similaire à l'exemple suivant :

D:\Documents and Settings\<your user name>\My Documents\ 2005\Projects\EvenOdd\EvenOdd\bin\Debug\EvenOdd.exe.

Enregistrez le test générique.

Vous avez créé un test générique qui encapsule EvenOdd.exe. Ce test possède les caractéristiques suivantes :
- Vous pouvez exécuter le test à partir d'une ligne de commande.
- Le test retourne une valeur de 0 pour Réussite, ou de 1 pour Échec.
- Vous pouvez maintenant exécuter le test générique à partir de la fenêtre Affichage de tests ou de l'Explorateur de tests. Pour exécuter le test maintenant, consultez Exécution du test générique.

Exécution du test générique

Pour exécuter le test générique que vous avez créé

Ouvrez la fenêtre Affichage de tests.
Cliquez sur le test générique.
Dans la barre d'outils Affichage de tests, cliquez sur Exécuter la sélection.

Le fichier exécutable EvenOdd retourne une valeur aléatoire de 0 ou 1. En conséquence, lorsque le test générique qui encapsule EvenOdd s'exécute, il réussit ou échoue selon le nombre généré par EvenOdd. La fenêtre Résultats des tests affiche le résultat : Réussite ou Échec.

Remarque :

En général, un test générique réussit lorsque le fichier exécutable qu'il encapsule retourne une valeur de 0 et il échoue si toute autre valeur est retournée.

Vous pouvez également passer des arguments au fichier exécutable EvenOdd. Un test basé sur EvenOdd.exe réussit ou échoue selon les arguments fournis. Pour une description des valeurs retournées par EvenOdd.exe, consultez Exemple de test générique.
Pour passer un argument lorsque vous exécuter le test générique, sur la page TestGénérique1.generic, tapez 12 sur la ligne Arguments de ligne de commande à passer au test générique et réexécutez le test.

Parce que vous avez passé un nombre pair, le test réussit. Vous pouvez vérifier ce résultat dans la fenêtre Résultats des tests.
(Facultatif) Exécutez le test plusieurs fois, en passant différentes valeurs.

Quelques tests ou programmes exécutables existants nécessitent des fichiers supplémentaires pour leur exécution. Vous pouvez spécifier des fichiers à déployer avec un test générique. Pour plus d'informations, consultez Déploiement d'un fichier lorsque vous exécutez le test générique.

Remarque :
En général, un test générique réussit lorsque le fichier exécutable qu'il encapsule retourne une valeur de 0 et il échoue si toute autre valeur est retournée.

Déploiement d'un fichier lorsque vous exécutez le test générique

Pour déployer un fichier supplémentaire lorsque vous exécutez le test générique

Créez un fichier et enregistrez-le sous le nom mydeployedfile.txt. Ce fichier peut être vide. Notez le dossier dans lequel vous l'avez créé.
Sous Fichiers supplémentaires à déployer avec ce test générique, cliquez sur Ajouter.

La boîte de dialogue Ajouter des fichiers de déploiement s'affiche.
Dans la boîte de dialogue Ajouter des fichiers de déploiement, sous Types de fichiers, cliquez sur Tous les fichiers (*.*).
Accédez au dossier qui contient monfichierdéployé.txt, sélectionnez le fichier, puis cliquez sur Ouvrir.

Vous avez spécifié que monfichierdéployé.txt doit être déployé lorsque vous exécutez le test générique.

Dans les étapes suivantes, vous pouvez vérifier que le fichier est déployé. Pour ce faire, utilisez une fonctionnalité spécifique d'EvenOdd.exe qui génère le résultat Réussite ou Échec selon que le fichier que vous avez spécifié est présent ou absent.
Dans le test générique, modifiez le paramètre d'exécution Arguments de ligne de commande à passer au test générique en lui assignant la valeur suivante : 12 "%RépDéploiementTest%\\monfichierdéployé.txt"
Enregistrez le test générique.

Deux arguments de ligne de commande sont maintenant passés au test générique. Cette modification entraîne l'utilisation par EvenOdd.exe d'un critère différent pour obtenir le résultat Réussite ou Échec. Lorsque vous passez deux arguments, le premier n'est pas pris en compte. Si le fichier spécifié par le deuxième argument existe dans le même répertoire que le test, celui-ci réussit. Toutefois, si le fichier n'a pas été déployé ou si le nom du fichier spécifié dans l'argument de ligne de commande ne correspond pas au nom du fichier déployé, le test échoue.

Pour exécuter le test maintenant, consultez Exécution du test générique.

Voir aussi

Share via