Partager via

WebTest, classe

  • Article

Classe de base pour tous les tests des performances de site Web. Les tests de performances Web codés qui sont écrits en C# dérivent directement de cette classe.

Hiérarchie d'héritage

System.Object
  Microsoft.VisualStudio.TestTools.WebTesting.WebTest
    Microsoft.VisualStudio.TestTools.WebTesting.DeclarativeWebTest
    Microsoft.VisualStudio.TestTools.WebTesting.ThreadedWebTest

Espace de noms :  Microsoft.VisualStudio.TestTools.WebTesting
Assembly :  Microsoft.VisualStudio.QualityTools.WebTestFramework (dans Microsoft.VisualStudio.QualityTools.WebTestFramework.dll)

Syntaxe

'Déclaration
<SerializableAttribute> _
Public MustInherit Class WebTest _
    Implements IEnumerable

[SerializableAttribute]
public abstract class WebTest : IEnumerable

[SerializableAttribute]
public ref class WebTest abstract : IEnumerable

[<AbstractClass>]
[<SerializableAttribute>]
type WebTest =  
    class
        interface IEnumerable
    end

public abstract class WebTest implements IEnumerable

Le type WebTest expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée WebTest Initialise une nouvelle instance d'une classe qui est dérivée de la classe WebTest.

Début

Propriétés

  Nom Description
Propriété publique Context Obtient ou définit un objet qui contient des variables de contexte qui sont disponibles pour le test de performances Web au moment de l'exécution.
Propriété publique DataSources Obtient la collection de sources de données définies pour le test de performances Web.
Propriété publique Guid Obtient ou définit le GUID qui identifie de manière unique chaque instance de WebTest.
Propriété publique InheritFromWebTest Obtient l'objet WebTest pour le test de performances de site Web parent lorsque ce test est inclus dans un autre et hérite des propriétés du test parent.
Propriété publique LastRequestOutcome
Propriété publique LastResponse Obtient la dernière réponse reçue pour une requête de niveau supérieur dans ce test de performances Web.
Propriété publique Name Obtient le nom du scénario de test.
Propriété publique Outcome Obtient ou définit le résultat Réussite ou Échec de la demande de test de performances Web.
Propriété publique Password Obtient et définit le mot de passe utilisé pour l'authentification.
Propriété publique PreAuthenticate Obtient ou définit une valeur qui indique s'il faut pré-authentifier toutes les requêtes dans le test de performances Web.
Propriété publique Proxy Obtient ou définit une valeur qui représente un serveur proxy pour le test de performances Web à utiliser.
Propriété publique RequestBodyCaptureLimit Obtient ou définit la limite, en octets, qui est utilisée pour capturer des données de requête.
Propriété publique ResponseBodyCaptureLimit Obtient ou définit la limite, en octets, qui est utilisée pour capturer des données de réponse.
Propriété publique StopOnError Obtient ou définit si le test doit cesser ou non son exécution lorsqu'une erreur se produit.
Propriété publique UserName Obtient et définit le nom d'utilisateur utilisé pour l'authentification.
Propriété publique ValidationRuleReferences Obtient la collection de références aux règles de validation au niveau du test de performances Web.
Propriété publique WebProxy Obtient ou définit le proxy Web à utiliser par ce test de performances Web.
Propriété publique WebTestPluginReferences Obtient la collection de références aux plug-ins de test de performances Web.

Début

Méthodes

  Nom Description
Méthode publique AddCommentToResult Ajoute un commentaire au résultat de test de performances Web qui suit le dernier élément effectué (requête de test de performances Web, transaction ou test de performances Web inclus).
Méthode publique AddDataSource(String, String, DataBindingAccessMethod, array<String[]) Ajoute une source de données à la collection de données contenue dans le test de performances Web.
Méthode publique AddDataSource(String, String, String, DataBindingAccessMethod, array<String[]) Ajoute une source de données à la collection de données contenue dans le test de performances Web.
Méthode publique AddDataSource(String, String, String, DataBindingAccessMethod, DataBindingSelectColumns, array<String[])
Méthode publique AddDataSourceBinding Définit une relation de liaison et l'ajoute à la collection de liaisons de la source de données pour le test de performances Web.
Méthode publique BeginCondition
Méthode publique BeginLoop
Méthode publique BeginTransaction Démarre une minuterie de transaction en utilisant le nom spécifié.
Méthode publique EndCondition
Méthode publique EndLoop
Méthode publique EndTransaction(String) Termine une minuterie de transaction avec le nom spécifié.
Méthode publique EndTransaction(String, Boolean) Termine la transaction spécifiée.
Méthode publique Equals Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publique ExecuteConditionalRule
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetDataTableRowCount
Méthode publique GetEnumerator Obtient un énumérateur qui énumère les éléments du test de performances Web.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetRequestEnumerator En cas de substitution dans une classe dérivée, retourne une interface IEnumerator<T> qui prend en charge une itération simple sur une collection générique de WebTestRequest.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique IncludeWebTest(String) Appelle un test de performances Web à partir d'un test de performances Web codé.
Méthode publique IncludeWebTest(WebTest) Appelle un test de performances Web à partir d'un test de performances Web codé.
Méthode publique IncludeWebTest(String, Boolean) Appelle un test de performances Web à partir d'un test de performances Web codé.
Méthode publique IncludeWebTest(WebTest, Boolean) Appelle un test de performances Web à partir d'un test de performances Web codé.
Méthode publique InitializeDataBinding Ajoute des informations de source de données et de liaison de données à partir d'attributs à l'instance actuelle.
Méthode publique InternalSetOutcome
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique MoveDataTableCursor(String, String) Avance le curseur dans la table de données à l'enregistrement suivant.
Méthode publique MoveDataTableCursor(String, String, Int32)
Méthode publique RegisterDataSourceInLoop
Méthode publique ReloadDataTable
Méthode publique Stop Arrête le test de performances Web en cours.
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

  Nom Description
Événement public PostPage
Événement public PostRequest Se produit après chaque requête exécutée par ce test de performances Web.
Événement public PostTransaction
Événement public PostWebTest Se produit après la série de tests de performances de site Web.
Événement public PrePage
Événement public PreRequest Se produit avant chaque requête exécutée par ce test de performances Web.
Événement public PreRequestDataBinding
Événement public PreTransaction
Événement public PreWebTest Se produit avant l'exécution du test de performances de site Web.
Événement public ValidateResponse Se produit lorsque la réponse à une requête de test de performances Web est reçue et est prête à être validée.
Événement public ValidateResponseOnPageComplete

Début

Notes

Pour créer un test des performances Web codé dans Visual Basic 2005, consultez ThreadedWebTest.

Pour obtenir la liste des valeurs initiales des propriétés d'une instance de la classe WebTest, consultez le constructeur WebTest.

Pour plus d'informations sur l'exécution d'un test en dehors de Visual Studio 2005 Team System, consultez Exécution de tests automatisés à partir de la ligne de commande.

Cette classe est sérialisable.

Remarques à l'attention des héritiers

Lorsque vous héritez de WebTest, vous devez substituer GetRequestEnumerator.

Exemples

Le test de performances Web suivant extrait des valeurs qui représentent l'état de cases à cocher et ajoute les valeurs au contexte.

namespace TestProject1
{
    using System;
    using System.Collections.Generic;
    using Microsoft.VisualStudio.TestTools.WebTesting;
    using ClassLibrary2;

    public class MyWebTest : WebTest
    {
        public MyWebTest()
        {
            this.PreAuthenticate = true;
        }

        public override IEnumerator<WebTestRequest> GetRequestEnumerator()
        {
            WebTestRequest request1 = new WebTestRequest("https://localhost/ts");
            ExtractCheckBoxes rule1 = new ExtractCheckBoxes();
            rule1.FindCheckedBoxes = true;
            rule1.ContextParameterName = "CheckedBoxes";
            request1.ExtractValues += new EventHandler
                <ExtractionEventArgs>(rule1.Extract);
            ExtractCheckBoxes rule2 = new ExtractCheckBoxes();
            rule2.FindCheckedBoxes = false;
            rule2.ContextParameterName = "";
            request1.ExtractValues += new EventHandler
                <ExtractionEventArgs>(rule2.Extract);
            yield return request1;
        }
    }
}

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.VisualStudio.TestTools.WebTesting, espace de noms

Autres ressources

Understanding Web Tests

Working with Web Tests

Comment : créer un test des performances de site Web codé