Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ThreadedWebTest Class

 

Represents a base class for a coded Web performance test that uses a single thread per Web performance test iteration.

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

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

public abstract class ThreadedWebTest : WebTest

NameDescription
System_CAPS_protmethodThreadedWebTest()

Initializes a new instance of the ThreadedWebTest class.

NameDescription
System_CAPS_pubpropertyContext

Gets or sets an object that contains context variables that are available to the Web performance test at run time.(Inherited from WebTest.)

System_CAPS_pubpropertyDataSources

Gets the collection of data sources that are defined for the Web performance test.(Inherited from WebTest.)

System_CAPS_pubpropertyGuid

Gets or sets a GUID that uniquely identifies each instance of a WebTest.(Inherited from WebTest.)

System_CAPS_pubpropertyInheritFromWebTest

Gets the WebTest object for the parent Web performance test when this Web performance test is included in another Web performance test and inherits properties from the parent Web performance test. (Inherited from WebTest.)

System_CAPS_pubpropertyLastRequestOutcome

(Inherited from WebTest.)

System_CAPS_pubpropertyLastResponse

Gets the last response that was received for a top-level request in this Web performance test.(Inherited from WebTest.)

System_CAPS_pubpropertyName

Gets the name of the test case.(Inherited from WebTest.)

System_CAPS_pubpropertyOutcome

Gets or sets the Pass or Fail outcome of the Web performance test.(Inherited from WebTest.)

System_CAPS_pubpropertyPassword

Gets and sets the password that is used for authentication.(Inherited from WebTest.)

System_CAPS_pubpropertyPreAuthenticate

Gets or sets a value that indicates whether to pre-authenticate all requests in the Web performance test.(Inherited from WebTest.)

System_CAPS_pubpropertyProxy

Gets or sets a value that represents a proxy server for the Web performance test to use.(Inherited from WebTest.)

System_CAPS_pubpropertyRequestBodyCaptureLimit

Gets or sets the limit, in bytes, that is used to capture request data.(Inherited from WebTest.)

System_CAPS_pubpropertyResponseBodyCaptureLimit

Gets or sets the limit, in bytes, that is used to capture response data.(Inherited from WebTest.)

System_CAPS_pubpropertyResultsLocale

(Inherited from WebTest.)

System_CAPS_pubpropertyStopOnError

Gets or sets the indication of whether the test should stop running when an error occurs. (Inherited from WebTest.)

System_CAPS_pubpropertyUserName

Gets and sets the user name that is used for authentication.(Inherited from WebTest.)

System_CAPS_pubpropertyValidationRuleReferences

Gets the collection of references to Web performance test-level validation rules.(Inherited from WebTest.)

System_CAPS_pubpropertyWebProxy

Gets or sets the Web proxy for this Web performance test to use.(Inherited from WebTest.)

System_CAPS_pubpropertyWebTestPluginReferences

Gets the collection of references to Web performance test plug-ins.(Inherited from WebTest.)

NameDescription
System_CAPS_pubmethodAddCommentToResult(String)

Adds a comment to the Web performance test result that follows the most recently completed Web performance test request, transaction, or included Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodAddDataSource(String, String, DataBindingAccessMethod, String[])

Adds a data source to the data collection that is contained by the Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodAddDataSource(String, String, String, DataBindingAccessMethod, DataBindingSelectColumns, String[])

(Inherited from WebTest.)

System_CAPS_pubmethodAddDataSource(String, String, String, DataBindingAccessMethod, String[])

Adds a data source to the data collection that is contained by the Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodAddDataSourceBinding(String, String, String, String)

Defines a binding relationship and adds it to the data source binding collection for the Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodBeginCondition(ConditionalRule)

(Inherited from WebTest.)

System_CAPS_pubmethodBeginLoop(ConditionalRule, Int32, Boolean)

(Inherited from WebTest.)

System_CAPS_pubmethodBeginTransaction(String)

Starts a transaction timer by using the specified name.(Inherited from WebTest.)

System_CAPS_pubmethodEndCondition(ConditionalRule)

(Inherited from WebTest.)

System_CAPS_pubmethodEndLoop(ConditionalRule)

(Inherited from WebTest.)

System_CAPS_pubmethodEndTransaction(String)

Ends a transaction timer with the specified name.(Inherited from WebTest.)

System_CAPS_pubmethodEndTransaction(String, Boolean)

Ends the specified transaction.(Inherited from WebTest.)

System_CAPS_pubmethodEquals(Object)

(Inherited from Object.)

System_CAPS_pubmethodExecuteConditionalRule(ConditionalRule)

(Inherited from WebTest.)

System_CAPS_protmethodFinalize()

(Inherited from Object.)

System_CAPS_pubmethodGetDataTableRowCount(String, String)

(Inherited from WebTest.)

System_CAPS_pubmethodGetEnumerator()

Gets an Enumerator that enumerates the items in the Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodGetHashCode()

(Inherited from Object.)

System_CAPS_pubmethodGetRequestEnumerator()

This API supports the product infrastructure and is not intended to be used directly from your code. This method returns the next request to be submitted in a Web performance test for Web performance tests that extend the ThreadedWebTest class. (Overrides WebTest.GetRequestEnumerator().)

System_CAPS_pubmethodGetType()

(Inherited from Object.)

System_CAPS_pubmethodIncludeWebTest(String)

Calls a coded Web performance test from within a coded Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodIncludeWebTest(String, Boolean)

Calls a coded Web performance test from within a coded Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodIncludeWebTest(WebTest)

Calls a coded Web performance test from within a coded Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodIncludeWebTest(WebTest, Boolean)

Calls a coded Web performance test from within a coded Web performance test.(Inherited from WebTest.)

System_CAPS_pubmethodInitializeDataBinding()

Adds data source and data binding information from attributes to the current instance.(Inherited from WebTest.)

System_CAPS_pubmethodInternalSetOutcome(Outcome)

(Inherited from WebTest.)

System_CAPS_protmethodMemberwiseClone()

(Inherited from Object.)

System_CAPS_pubmethodMoveDataTableCursor(String, String)

Advances the cursor in the data table to the next record.(Inherited from WebTest.)

System_CAPS_pubmethodMoveDataTableCursor(String, String, Int32)

(Inherited from WebTest.)

System_CAPS_pubmethodRegisterDataSourceInLoop(ConditionalRule, String, String)

(Inherited from WebTest.)

System_CAPS_pubmethodReloadDataTable(String, String)

(Inherited from WebTest.)

System_CAPS_pubmethodRun()

When overridden in a derived class, runs the coded Web performance test of the user.

System_CAPS_pubmethodSend(WebTestRequest)

Sends a WebTestRequest to be run by the Web performance test engine.

System_CAPS_pubmethodStop()

(Overrides WebTest.Stop().)

System_CAPS_pubmethodToString()

(Inherited from Object.)

NameDescription
System_CAPS_pubeventPostPage

(Inherited from WebTest.)

System_CAPS_pubeventPostRequest

Occurs after each request that this Web performance test runs.(Inherited from WebTest.)

System_CAPS_pubeventPostTransaction

(Inherited from WebTest.)

System_CAPS_pubeventPostWebTest

Occurs after the Web performance test runs.(Inherited from WebTest.)

System_CAPS_pubeventPrePage

(Inherited from WebTest.)

System_CAPS_pubeventPreRequest

Occurs before each request this Web performance test runs.(Inherited from WebTest.)

System_CAPS_pubeventPreRequestDataBinding

(Inherited from WebTest.)

System_CAPS_pubeventPreTransaction

(Inherited from WebTest.)

System_CAPS_pubeventPreWebTest

Occurs before the Web performance test runs.(Inherited from WebTest.)

System_CAPS_pubeventValidateResponse

Occurs when the response to a Web performance test request has been received and is ready to be validated.(Inherited from WebTest.)

System_CAPS_pubeventValidateResponseOnPageComplete

(Inherited from WebTest.)

This should always be the base class for all coded Web performance tests that are written in languages that do not support Visual C# iterator-like syntax. To write a Web performance test in Visual C#, see WebTest for an example. To run a test outside Visual Studio 2005 Team System, see Running automated tests from the command line for more information.

This class must be inherited; it cannot be instantiated.

Notes to Inheritors:

When you inherit from ThreadedWebTest, you must override Run.

Legacy Code Example

The following is a coded Web performance test called MyCodedWebTest that inherits from ThreadedWebTest. The second request posts the form information that is contained in three controls back to the server.

Option Strict Off
Option Explicit On

Imports Microsoft.VisualStudio.TestTools.WebTesting
Imports Microsoft.VisualStudio.TestTools.WebTesting.Rules
Imports System
Imports System.Collections.Generic

Namespace TestProject2

    Public Class MyCodedWebTest
        Inherits ThreadedWebTest

        Public Sub New()
            MyBase.New
            Me.PreAuthenticate = true
            Me.Proxy = "myproxy.com:80"
        End Sub

        Public Overrides Sub Run()
            Dim request1 As WebTestRequest = New WebTestRequest _
                ("http://localhost/MyWebSite")
            request1.ThinkTime = 1
            Dim rule1 As ExtractHiddenFields = New ExtractHiddenFields
            rule1.ContextParameterName = "1"
            AddHandler request1.ExtractValues, AddressOf rule1.Extract
            MyBase.Send(request1)

            Dim request2 As WebTestRequest = New WebTestRequest _
                ("http://localhost/MyWebSite/Default.aspx")
            request2.Method = "POST"
            Dim request2Body As FormPostHttpBody = New FormPostHttpBody
            request2Body.FormPostParameters.Add("__VIEWSTATE", "{{$HIDDEN1" + _
                ".__VIEWSTATE}}")
            request2Body.FormPostParameters.Add("Button1", "Button")
            request2Body.FormPostParameters.Add("TextBox1", "Hello text")
            request2.Body = request2Body
            Dim rule2 As ExtractHiddenFields = New ExtractHiddenFields
            rule2.ContextParameterName = ""
            AddHandler request2.ExtractValues, AddressOf rule2.Extract
            MyBase.Send(request2)
        End Sub
    End Class
End Namespace

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: