ILoadTestPlugin, interface
Mise à jour : novembre 2007
Définit une interface qui est implémentée pour autoriser une classe écrite par l'utilisateur à gérer des événements qui se produisent lors de l'exécution du test de charge et des tests contenus dans celui-ci.
Espace de noms : Microsoft.VisualStudio.TestTools.LoadTesting
Assembly : Microsoft.VisualStudio.QualityTools.LoadTestFramework (dans Microsoft.VisualStudio.QualityTools.LoadTestFramework.dll)
Syntaxe
Public Interface ILoadTestPlugin
Dim instance As ILoadTestPlugin
public interface ILoadTestPlugin
public interface class ILoadTestPlugin
public interface ILoadTestPlugin
Notes
Cela peut être implémenté par une classe écrite par l'utilisateur pour intégrer le code écrit par l'utilisateur au moteur d'exécution du test de charge sur l'agent. Ce plug-in est spécifié dans l'éditeur de test de charge.
Vous pouvez créer un plug-in de test de charge pour exécuter du code à des moments différents au cours de l'exécution d'un test de charge, par exemple après qu'un seuil soit enfreint, avant qu'un test de charge démarre et après qu'un test de charge se termine, avant qu'une itération de test démarre et après qu'elle se termine, lorsqu'un test de charge est abandonné ou lorsque la charge dans le test est modifiée. Les événements que l'implémentation de ILoadTestPlugin peut gérer sont les suivants : LoadTestStarting, LoadTestFinished, LoadTestWarmupComplete, TestStarting, TestFinished, TestSelected, ThresholdExceeded, HeartBeat() et LoadTestAborted.
Une implémentation d'un plug-in de test de charge peut être utilisée pour étendre ou modifier le comportement d'un test de charge durant son exécution. La liste suivante répertorie différentes utilisations possibles d'un plug-in de test de charge :
Démarrer un processus externe, tel qu'un outil de contrôle, juste avant que le test de charge démarre, et l'arrêter lorsque le test de charge est terminé.
Fournir un contrôle par programmation sur la charge utilisateur utilisée durant l'exécution du test de charge, substituant ainsi la charge utilisateur spécifiée dans l'éditeur de test de charge.
Fournir un contrôle par programmation sur la sélection d'un test individuel à exécuter dans le test de charge, substituant ainsi l'algorithme de sélection du test par défaut.
Abandonner le test de charge si la valeur d'un compteur de performance provoque l'échec d'une règle de seuil définie dans le test de charge.
Maintenir une variable commune à toutes les itérations de tests dans un test de charge. Pour ce faire, le plug-in de test de charge implémente une variable en tant que propriété statique à laquelle accèdent les tests sous charge. La variable est initialisée dans la méthode Initialize du plug-in de test de charge. Un gestionnaire d'événements est ajouté pour l'événement LoadTestFinished qui peut être utilisé pour accéder à la valeur finale en vue de créer des rapports.
Remarques à l'attention des implémenteurs :
Lorsque le test de charge s'exécute sur plusieurs agents, la classe du plug-in de test de charge est instanciée sur tous les agents. Si le plug-in de test de charge doit effectuer une opération sur un seul agent, il doit vérifier la propriété AgentId de l'objet LoadTestContext et exécuter uniquement l'opération si AgentId a la valeur 1.
Exemples
Pour obtenir un exemple, consultez Comment : créer un plug-in de test de charge.
Voir aussi
Référence
Microsoft.VisualStudio.TestTools.LoadTesting, espace de noms