WebTest-Klasse

Artikel
07/20/2011

Basisklasse für alle Webleistungstests. In C# programmierte codierte Webleistungstests werden direkt von dieser Klasse abgeleitet.

Vererbungshierarchie

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

Namespace: Microsoft.VisualStudio.TestTools.WebTesting
Assembly: Microsoft.VisualStudio.QualityTools.WebTestFramework (in Microsoft.VisualStudio.QualityTools.WebTestFramework.dll)

Syntax

'Declaration
<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

Der WebTest-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	WebTest	Initialisiert eine neue Instanz einer Klasse, die von der WebTest-Klasse abgeleitet ist.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Context	Ruft ein Objekt ab oder legt ein Objekt fest, das Kontextvariablen enthält, die dem Webleistungstest zur Laufzeit zur Verfügung stehen.
	DataSources	Ruft die Auflistung von für den Webleistungstest definierten Datenquellen ab.
	Guid	Ruft eine GUID ab, die jede Instanz von WebTest eindeutig identifiziert, oder legt diese fest.
	InheritFromWebTest	Ruft das WebTest-Objekt für den übergeordneten Webleistungstest ab, wenn dieser Webleistungstest in einem anderen Webleistungstest enthalten ist und vom übergeordneten Webleistungstest Eigenschaften erbt.
	LastRequestOutcome
	LastResponse	Ruft die letzte Antwort ab, die für eine Anforderung der obersten Ebene in diesem Webleistungstest empfangen wurde.
	Name	Ruft den Namen des Testfalls ab.
	Outcome	Ruft den Erfolg oder Fehler des Webleistungstests ab oder legt sie fest.
	Password	Ruft das zur Authentifizierung verwendete Kennwort ab oder legt dieses fest.
	PreAuthenticate	Ruft einen Wert ab, der angibt, ob alle Anforderungen innerhalb des Webleistungstests vorauthentifiziert werden sollen, oder legt diesen Wert fest.
	Proxy	Ruft einen Wert ab, der einen Proxyserver für den zu verwendenden Webleistungstest darstellt, oder legt diesen fest.
	RequestBodyCaptureLimit	Ruft das zum Erfassen von Anforderungsdaten verwendete Limit (in Bytes) ab oder legt dieses fest.
	ResponseBodyCaptureLimit	Ruft das zum Erfassen von Antwortdaten verwendete Limit (in Bytes) ab oder legt dieses fest.
	StopOnError	Ruft die Angabe ab, ob die Ausführung des Tests beendet werden soll, wenn ein Fehler auftritt, oder legt sie fest.
	UserName	Ruft den zur Authentifizierung verwendeten Benutzernamen ab oder legt diesen fest.
	ValidationRuleReferences	Ruft die Auflistung der Verweise auf Validierungsregeln auf Webleistungstestebene ab.
	WebProxy	Ruft den Webproxy ab oder legt den Webleistungsproxy fest, der für diesen Webtest verwendet werden soll.
	WebTestPluginReferences	Ruft die Auflistung der Verweise auf Webleistungstest-Plug-Ins ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddCommentToResult	Fügt dem Webleistungstestergebnis, das auf die zuletzt abgeschlossene Webleistungstestanforderung, Transaktion oder enthaltenen Webleistungstest folgt, einen Kommentar hinzu.
	AddDataSource(String, String, DataBindingAccessMethod, array<String[])	Fügt der im Webleistungstest enthaltenen Datenauflistung eine Datenquelle hinzu.
	AddDataSource(String, String, String, DataBindingAccessMethod, array<String[])	Fügt der im Webleistungstest enthaltenen Datenauflistung eine Datenquelle hinzu.
	AddDataSource(String, String, String, DataBindingAccessMethod, DataBindingSelectColumns, array<String[])
	AddDataSourceBinding	Definiert eine Bindungsbeziehung und fügt sie der Datenquellenbindungs-Auflistung für den Webleistungstest hinzu.
	BeginCondition
	BeginLoop
	BeginTransaction	Startet einen Transaktionszeitgeber anhand des angegebenen Namens.
	EndCondition
	EndLoop
	EndTransaction(String)	Beendet einen Transaktionszeitgeber mit dem angegebenen Namen.
	EndTransaction(String, Boolean)	Beendet die angegebene Transaktion.
	Equals	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	ExecuteConditionalRule
	Finalize	Ermöglicht es einem Objekt, zu versuchen, Ressourcen freizugeben und führt andere Bereinigungsvorgänge aus, bevor es von Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetDataTableRowCount
	GetEnumerator	Ruft einen Enumerator ab, der die Elemente im Webleistungstest auflistet.
	GetHashCode	Fungiert als Hashfunktion für einen besonderen Typ. (Von Object geerbt.)
	GetRequestEnumerator	Gibt beim Überschreiben in einer abgeleiteten Klasse eine IEnumerator<T>-Schnittstelle zurück, die eine einfache Iteration über eine generische Auflistung von WebTestRequest unterstützt.
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IncludeWebTest(String)	Ruft einen codierten Webleistungstest von einem codierten Webleistungstest aus auf.
	IncludeWebTest(WebTest)	Ruft einen codierten Webleistungstest von einem codierten Webleistungstest aus auf.
	IncludeWebTest(String, Boolean)	Ruft einen codierten Webleistungstest von einem codierten Webleistungstest aus auf.
	IncludeWebTest(WebTest, Boolean)	Ruft einen codierten Webleistungstest von einem codierten Webleistungstest aus auf.
	InitializeDataBinding	Fügt der aktuellen Instanz Datenquellen- und Datenbindungsinformationen aus Attributen hinzu.
	InternalSetOutcome
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	MoveDataTableCursor(String, String)	Verschiebt den Cursor in der Datentabelle zum nächsten Datensatz.
	MoveDataTableCursor(String, String, Int32)
	RegisterDataSourceInLoop
	ReloadDataTable
	Stop	Beendet den aktuellen Webleistungstest.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	PostPage
	PostRequest	Tritt nach jeder Anforderung auf, die von diesem Webleistungstest ausgeführt wird.
	PostTransaction
	PostWebTest	Tritt nach den Webleistungstestläufen auf.
	PrePage
	PreRequest	Tritt vor jeder Anforderung auf, die von diesem Webleistungstest ausgeführt wird.
	PreRequestDataBinding
	PreTransaction
	PreWebTest	Tritt vor den Webleistungstestläufen auf.
	ValidateResponse	Tritt auf, wenn die Antwort auf eine Webleistungstestanforderung eingegangen ist und zur Validierung bereit ist.
	ValidateResponseOnPageComplete

Zum Seitenanfang

Hinweise

Informationen zum Erstellen eines codierten Webleistungstests in Visual Basic 2005 finden Sie unter ThreadedWebTest.

Eine Liste von Anfangswerten für die Eigenschaften einer Instanz der WebTest-Klasse finden Sie im Abschnitt zum WebTest-Konstruktor.

Weitere Informationen zum Ausführen eines Tests außerhalb von Visual Studio 2005 Team System finden Sie unter Ausführen von automatisierten Tests über die Befehlszeile.

Diese Klasse kann serialisiert werden.

Hinweise zur Vererbung

Wenn Sie von WebTest erben, müssen Sie GetRequestEnumerator überschreiben.

Beispiele

Der folgende Webleistungstest extrahiert Werte, die den Status von Kontrollkästchen darstellen, und fügt die Werte dem Kontext hinzu.

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;
        }
    }
}

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.