Partager via


Comment : créer un plug-in de test de charge

Vous pouvez créer un plug-in de test de charge pour exécuter du code à différents stades de l'exécution du test de charge.Vous pouvez créer un plug-in pour développer ou modifier la fonctionnalité intégrée du test de charge.Par exemple, vous pouvez coder un plug-in de test de charge pour définir ou modifier le modèle de test de charge pendant l'exécution du test de charge.Pour cela, vous devez créer une classe qui hérite de l'interface de ILoadTestPlugin.Cette classe doit implémenter la méthode Initialize de cette interface.Pour plus d’informations, consultez ILoadTestPlugin.

[!REMARQUE]

Vous pouvez également créer des plug-ins pour les tests de performances de site Web.Pour plus d'informations, consultez Comment : créer un plug-in de test des performances de site Web.

Configuration requise

  • Visual Studio Ultimate

Pour créer un plug-in de test de charge à l'aide de Visual C#

  1. Ouvrez un projet de test performance web et de charge qui contient un test de performances de site Web, puis ouvrez le test de performances de site Web.

    Pour plus d’informations, consultez Comment : créer et configurer des projets de tests automatisés.

  2. Ajoutez un test de charge au projet de test et configurez-le pour exécuter un test de performances de site Web.

    Pour plus d’informations, consultez Création de tests de charge à l'aide de l'Assistant Nouveau test de charge.

  3. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la solution et sélectionnez Ajouter, puis cliquez sur Nouveau projet.

    La boîte de dialogue Ajouter un nouveau projet s'affiche.

  4. Sous Modèles installés, sélectionnez Visual C#.

  5. Dans la liste des modèles, sélectionnez Bibliothèque de classes.

  6. Dans la zone de texte Nom, tapez le nom de votre classe.

  7. Cliquez sur OK.

  8. Le nouveau projet de bibliothèque de classes est ajouté à l'Explorateur de solutions et la nouvelle classe s'affiche dans l'éditeur de code.

  9. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier Références dans la nouvelle bibliothèque de classes et sélectionnez Ajouter une référence.

  10. La boîte de dialogue Ajouter une référence s'affiche.

  11. Cliquez sur l'onglet .NET, faites défiler la page, puis sélectionnez Microsoft.VisualStudio.QualityTools.LoadTestFramework.

  12. Cliquez sur OK.

    La référence à Microsoft.VisualStudio.QualityTools.LoadTestFramework est ajoutée au dossier Référence dans l'Explorateur de solutions.

  13. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud supérieur du projet de test de performance web et de charge qui contient le test de charge auquel vous souhaitez ajouter le plug-in du test de charge, puis sélectionnez Ajouter une référence.

  14. La boîte de dialogue Ajouter une référence s'affiche.

  15. Cliquez sur l'onglet Projets et sélectionnez le projet de bibliothèque de classes.

  16. Cliquez sur OK.

  17. Dans l'éditeur de code, ajoutez une instruction using pour l'espace de noms Microsoft.VisualStudio.TestTools.LoadTesting.

  18. Implémentez l'interface ILoadTestPlugin pour la classe créée dans le projet de bibliothèque de classes.Pour un exemple d'implémentation, reportez-vous à la section suivante.

  19. Après avoir écrit le code, générez le nouveau projet.

  20. Cliquez avec le bouton droit sur le nœud supérieur du test de charge, puis cliquez sur Ajouter un plug-in de test de charge.

    La boîte de dialogue Ajouter un plug-in de test de charge s'affiche.

  21. Sous Sélectionner un plug-in, sélectionnez votre classe du plug-in du test de charge.

  22. Dans le volet Propriétés du plug-in sélectionné, définissez les valeurs initiales du plug-in à utiliser au moment de l'exécution.

    [!REMARQUE]

    Vous pouvez exposer autant de propriétés que vous souhaitez de vos plug-ins ; il suffit de les rendre publics, définissables et d'un type de base, tel qu'un entier, une valeur booléenne ou une chaîne.Vous pouvez également modifier ultérieurement les propriétés du plug-in de test de performances de site Web dans la fenêtre Propriétés.

  23. Cliquez sur OK.

    Le plug-in est ajouté au dossier Plug-ins de test de charge.

    Mise en gardeAttention

    Vous pouvez obtenir une erreur semblable au cas suivant lorsque vous exécutez un test de performances de site Web ou un test de charge qui utilise votre plug-in :

    Request failed: Exception in <plug-in> event: Could not load file or assembly '<"Plug-in name".dll file>, Version=<n.n.n.n>, Culture=neutral, PublicKeyToken=null' or one of its dependencies.The system cannot find the file specified.

    Cela est provoqué par les modifications de code apportées à chacun de vos plug-ins et la création d'une nouvelle version de la DLL (Version=0.0.0.0), mais le plug-in référence encore la version du plug-in d'origine.Pour résoudre ce problème, procédez comme suit :

    1. Dans votre projet de test de performance Web et de charge, un message d'avertissement s'affiche dans les références.Supprimez et rajoutez la référence à la DLL de votre plug-in.

    2. Supprimez le plug-in de votre test ou de l'emplacement approprié, puis rajoutez-le.

Exemple

Le code suivant illustre un plug-in de test de charge qui exécute du code personnalisé suite à un événement LoadTestFinished.Si ce code est exécuté sur un agent de test sur un ordinateur distant et si l'agent et le contrôleur de test n'ont pas de service SMTP localhost, le test de charge reste à l'état "En cours" car une boîte de message est ouverte.

[!REMARQUE]

Le code suivant requiert l'ajout d'une référence à System.Windows.Forms.

using System;
using Microsoft.VisualStudio.TestTools.LoadTesting;
using System.Net.Mail;
using System.Windows.Forms;

namespace LoadTestPluginTest
{
    public class MyLoadTestPlugin : ILoadTestPlugin
    {
        LoadTest myLoadTest;

        public void Initialize(LoadTest loadTest)
        {
            myLoadTest = loadTest;
            myLoadTest.LoadTestFinished += new
                EventHandler(myLoadTest_LoadTestFinished);
        }

        void myLoadTest_LoadTestFinished(object sender, EventArgs e)
        {
            try
            {
                // place custom code here
                MailAddress MyAddress = new MailAddress("someone@example.com");
                MailMessage MyMail = new MailMessage(MyAddress, MyAddress);
                MyMail.Subject = "Load Test Finished -- Admin Email";
                MyMail.Body = myLoadTest..Name + " has finished.";

                SmtpClient MySmtpClient = new SmtpClient("localhost");
                MySmtpClient.Send(MyMail);
            }

            catch (SmtpException ex)
            {
                MessageBox.Show(ex.InnerException.Message +
                    ".\r\nMake sure you have a valid SMTP.", "LoadTestPlugin", MessageBoxButtons.OK, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button1);
            }
        }
    }
} 

Huit événements sont associés à un test de charge et peuvent être gérés dans le plug-in de test de charge pour exécuter du code personnalisé avec le test de charge.Voici une liste des événements qui procurent un accès à différentes périodes de la série de tests de charge :

Voir aussi

Tâches

Comment : créer un plug-in de test des performances de site Web

Référence

ILoadTestPlugin

Autres ressources

Création et utilisation de plug-ins personnalisés pour les tests de charge et les tests de performances de site Web