Comment : créer un plug-in de niveau demande
Mise à jour : novembre 2007
Les demandes sont les instructions déclaratives qui constituent des tests Web. Les plug-ins de tests Web vous permettent d'isoler et de réutiliser du code en dehors des principales instructions déclaratives de votre test Web. Vous pouvez créer des plug-in et les ajouter à une demande individuelle aussi bien qu'au test Web qui le contient. Un plug-in de demande personnalisé permet d'appeler du code lorsqu'une demande particulière est exécutée dans un test Web.
.gif "Remarque") Remarque : |
|---|
Dans Visual Studio 2005 Team Edition for Testers, il était possible de créer un plug-in de demande au niveau test pour l'exécuter avec chaque demande au cours du test. Dans Team System 2008 Test Edition, les plug-in de niveau test prennent en charge l'interface de plug-in de demande et l'appliquent à chaque demande dans le test. Lorsque Team System 2008 Test Edition rencontre un plug-in de demande créé dans Visual Studio 2005, il convertit le plug-in en plug-in de niveau test équivalent. |
Chaque plug-in de demande de test Web comporte une méthode PreRequest et une méthode PostRequest. Après avoir joint un plug-in de demande à une requête http particulière, l'événement PreRequest est déclenché avant d'envoyer la requête et l'événement PostRequest après réception de la réponse.
Vous pouvez créer un plug-in de demande de test Web personnalisé en dérivant votre propre classe de la classe de base WebTestRequestPlugin.
En outre, vous pouvez utiliser des plug-ins de demande de test Web personnalisés avec des tests Web enregistrés. Les plug-in de demande de test Web personnalisés vous permettent de minimiser le code à écrire pour arriver à mieux contrôler vos tests Web. Toutefois, vous pouvez également les utiliser avec des tests Web codés. Pour plus d'informations, consultez Comment : créer un test Web codé.
Pour créer un plug-in de niveau demande
Ouvrez un projet de test qui contient un test Web.
Pour plus d'informations sur la création d'un projet de test, consultez Comment : créer un projet de test.
Dans la même solution, créez un projet de bibliothèque de classes pour stocker votre plug-in de demande.
Sélectionnez le projet de bibliothèque de classes, puis cliquez avec le bouton droit sur Ajouter une référence.
Sous l'onglet .NET, sélectionnez Microsoft.VisualStudio.QualityTools.WebTestFramework. Cliquez sur OK.
Dans votre projet de test, cliquez avec le bouton droit et sélectionnez Ajouter une référence.
Sous l'onglet Projets, sélectionnez le nouveau projet de bibliothèque de classes. Cliquez sur OK.
Écrivez le code de votre plug-in. Commencez par créer une nouvelle classe publique qui dérive de WebTestRequestPlugin.
Implémentez le code à l'intérieur de l'un des gestionnaires d'événements PreRequest et PostRequest ou dans les deux.
Après avoir écrit le code, générez le nouveau projet.
Ouvrez le test Web auquel vous souhaitez ajouter le plug-in de demande.
Cliquez avec le bouton droit sur la demande à laquelle vous souhaitez ajouter le plug-in, puis sélectionnez Ajouter un plug-in de requête.
La boîte de dialogue Ajouter un plug-in de requête de test Web s'affiche.
Sous Sélectionner un plug-in, sélectionnez votre nouveau plug-in, puis cliquez sur OK.
Le plug-in est ajouté au dossier Plug-ins de demande, qui est un dossier enfant de la requête http.
Exemple
Vous pouvez utiliser le code suivant pour créer un plug-in de test Web personnalisé.
using System;
using System.Collections.Generic;
using System.Windows.Forms;
using Microsoft.VisualStudio.TestTools.WebTesting;
namespace RequestPluginNamespace
{
public class MyWebRequestPlugin : WebTestRequestPlugin
{
public override void PostRequest(object sender, PostRequestEventArgs e)
{
MessageBox.Show(e.WebTest.Context.AgentName);
}
public override void PreRequest(object sender, PreRequestEventArgs e)
{
MessageBox.Show(e.Request.Url);
}
}
}
Voir aussi
Tâches
Comment : créer une règle d'extraction personnalisée
Comment : créer une règle de validation personnalisée
Comment : créer un plug-in de test de charge
Comment : créer un test Web codé
Comment : modifier un test Web existant