Microsoft.VisualStudio.TestTools.WebTesting Namespace
The Microsoft.VisualStudio.TestTools.WebTesting namespace supplies classes that enable Web performance testing. This namespace includes the WebTest class which is the base class for all Web performance tests. The WebTestRequest and WebTestResponse classes simulate the HTTP requests and responses of the Web pages under test. These classes use the FormPostHttpBody class to simulate the use of form post parameters. Microsoft.VisualStudio.TestTools.WebTesting also includes classes for data binding, test rules, identifying work items, query strings, HTTP context, and plug-ins that provide testing features.
Classes
Class | Description | |
---|---|---|
AlwaysExecuteRecorderPluginAttribute | Attribute to indicate that the recorder plug-in should always be executed. | |
BaseEnumStringConverter<T> | Helper class that helps with conversions between enum values and strings. | |
BinaryHttpBody | Represents an HTTP body that contains binary data. | |
Comment | Represents a comment that the test designer adds to a Web performance test. | |
ConditionalEventArgs | Represents the event arguments that are used for conditional loops and statements. | |
ConditionalRule | Condition rules are executed in a conditional loop or statement. These rules are intended to decide whether the body of the loop or statement must be executed. | |
ConditionalRuleException | Represents the exception that is thrown when an exception occurs during execution of any one of the three methods of a conditional rule. | |
ConditionalRuleReference | Base class for a reference to a particular conditional rule. | |
ConditionalRuleReferenceCollection | Represents a strongly typed container for Web-test conditional rule references. | |
ConditionConditionalRuleReference | Represents a reference to a conditional rule that will be used in a condition. | |
ConnectionFailedWebTestException | An exception that is thrown by the test engine for connection failure errors during a Web performance test. | |
ContextParameter | Represents a single parameter in the Web performance testing context that has a name and value. | |
ContextParameterCollection | Contains a strongly typed collection of ContextParameter objects. | |
CssIterationAttribute | Represents the project iteration to which this test corresponds. This class cannot be inherited. | |
CssProjectStructureAttribute | Represents the node in the team project hierarchy to which this test corresponds. | |
DataBindingAttribute | Contains information that defines data binding properties for a Web performance test. This class cannot be inherited. | |
DataSource | Defines a data source for a Web performance test. | |
DataSourceAttribute | Contains information that describes a data source for a Web performance test. This class cannot be inherited. | |
DataSourceCollection | Contains a strongly typed collection of DataSourceCollection objects. | |
DataSourceTable | An object that represents a table in a data source that you can use in a Web performance test. | |
DataSourceTableCollection | Contains a strongly typed collection of DataSourceTableCollection objects. | |
DeclarativeWebTest | Represents a declarative, XML-based Web performance test. | |
DeclarativeWebTestSerializer | Loads the contents of a .webtest file into an instance of the DeclarativeWebTest class. | |
DeploymentItemAttribute | Used to specify deployment items such as a file or directory for per-test-deployment. This class cannot be inherited. | |
ExtractHtmlSelectTag | Represents a rule that is used to extract the selected option from an HTML select tag. | |
ExtractHtmlTagInnerText | Represents a rule that is used to extract the inner text from an HTML tag. | |
ExtractionEventArgs | Provides data for the ExtractValues event. | |
ExtractionRule | Base class used to define rules for obtaining data from a Web response that is generated by a Web performance test. | |
ExtractionRuleReference | The ExtractionRuleReference class encapsulates the metadata about an ExtractionRule and the parameter values to use when an instance of the ExtractionRule is created when the Web performance test that uses the ExtractionRule is run. | |
ExtractionRuleReferenceCollection | Contains a strongly typed collection of ExtractionRuleReferenceCollection objects. | |
FileUploadParameter | Represents a file upload form post parameter. | |
ForLoopComparisonOperatorConverter | Helper class that helps with conversions between enum values and strings. | |
FormPostHttpBody | Represents an HTML form post body with a collection of form parameters. | |
FormPostParameter | Represents an HTML form POST parameter. | |
FormPostParameterCollection | Represents a strongly typed container for form post parameters. | |
HtmlAttribute | Represents an HTML attribute. | |
HtmlAttributeWithOffsets | Extends the basic HtmlAttribute and tracks the beginning and ending offsets within an HTML document. | |
HtmlDocument | Provides access to the set of HTML tags in an HTML response body. | |
HtmlTag | The HtmlTag object is the foundation of the HTML document and holds the parsed structure of the document. | |
HtmlTagInnerText | Represents the inner text of an HTML tag, and contains the beginning and ending offset of the inner text location in the whole document. | |
HtmlTagInnerTextParser | A specialized parser that is used to extract the inner text from HTML tags that are located in an HTML document. | |
HtmlTagWithOffsets | Extends the basic HtmlTag by tracking the beginning and ending tag offsets within the HTML document. | |
IncludeCodedWebTestAttribute | Contains information that defines a coded Web performance test that is included in another Web performance test. | |
IncludeDeclarativeWebTestAttribute | Contains information that defines a coded Web performance test that is included in another Web performance test. This class cannot be inherited. | |
IncludedWebTest | Represents a Web performance test that is included in another Web performance test. | |
LoopConditionalRuleReference | Class to contain a reference to a particular conditional rule that will be used in a loop. | |
NumericalComparisonOperatorConverter | Helper class that helps with conversions between enum values and strings. | |
OutcomeConverter | Helper class that helps with conversions between enum values and strings. | |
OwnerAttribute | Used to specify the person responsible for maintaining, running, and/or debugging the test. This class cannot be inherited. | |
Parameter | Represents an HTTP parameter base class. | |
PluginOrRuleProperty | Represents the name and value of a single property for a rule or a plug-in. | |
PostPageEventArgs | Provides data for the WebTest.PostPage event. | |
PostRequestEventArgs | Provides data for the WebTestRequest.PostRequest and WebTest.PostRequest events. | |
PostTransactionEventArgs | Provides data for the WebTest.PostTransaction event. | |
PostWebTestEventArgs | Provides data for the WebTest.PostWebTest event. | |
PostWebTestRecordingEventArgs | Event arguments that are used for pre-Web performance test and post-Web performance test recording callouts. | |
PrePageEventArgs | Provides data for the WebTest.PrePage event. | |
PreRequestDataBindingEventArgs | ||
PreRequestEventArgs | Provides data for the WebTest.PreRequest event. | |
PreTransactionEventArgs | Provides data for the WebTest.PreTransaction event. | |
PreWebTestEventArgs | Provides data for the WebTest.PreWebTest event. | |
PriorityAttribute | Used to specify the priority of a unit test. This class cannot be inherited. | |
PropertyCollection | Represents a strongly typed container for Web performance test rule properties. | |
QueryStringParameter | Represents an HTTP querystring parameter. | |
QueryStringParameterCollection | Represents a strongly typed container for query string parameters. | |
RequestBodyEditorPluginReference | Represents a plug-in for an HTTP request object. | |
StringComparisonOperatorConverter | Helper class that helps with conversions between enum values and strings. | |
StringHttpBody | Represents an HTTP body in string form used for SOAP support. | |
TestDescriptionAttribute | Used to specify the description of the test. This class cannot be inherited. | |
ThreadedWebTest | Represents a base class for a coded Web performance test that uses a single thread per Web performance test iteration. | |
TimeoutAttribute | Use this attribute to specify the time-out period of a Web performance test. | |
TransactionTimer | Represents a timed transaction in a Web performance test. This part of the Web performance test may include Web performance test requests, calls to included Web performance tests, or other Web performance test transactions. | |
ValidationEventArgs | Provides data for the ValidateResponse event. | |
ValidationRule | Verifies that requests return valid HTTP responses and that the contents of the response match the expected results. This class must be inherited. | |
ValidationRuleReference | The ValidationRuleReference class encapsulates the metadata about an ValidationRule and the parameter values to use when an instance of the ValidationRule is created when the Web performance test that uses the ValidationRule is run. | |
ValidationRuleReferenceCollection | Represents a serializable, strongly typed container for Web performance test validation rules. | |
WebTest | Base class for all Web performance tests. Coded Web performance tests that are written in C# derive directly from this class. | |
WebTestBaseCollection<T> | An abstract base class that is used to store a variety of Web performance tests. | |
WebTestCondition | This class represents the conditional statement constructs. It contains a collection of Web performance test items that are executed when the conditional rule is met. | |
WebTestConditionalConstruct | Base class for the conditional loop and the conditional statement constructs. | |
WebTestContext | Represents the context available to a WebTest. | |
WebTestCorrelationResult | Class to contain the result of a correlation that is applied when a Web performance test is executed in correlation mode. | |
WebTestEmptyTableException | Represents an Exception that occurs when data binding is being performed on an empty table. | |
WebTestEndOfDataException | The exception that is thrown when data binding is being performed on a table with the UniqueDataBindingAccessMethod when there are no more rows of data in the table. | |
WebTestError | Class to encapsulate errors that occur during Web performance test execution. | |
WebTestException | The exception that is thrown by the test engine for errors that occur while a test is running. | |
WebTestItem | Represents a base class for WebTestRequest. | |
WebTestItemCollection | Represents a strongly typed container for Web performance test items. | |
WebTestLoop | Represents a conditional loop that contains a collection of Web performance test items that are executed as long as the conditional rule is met. | |
WebTestPageStatistics | Contains statistics about the execution of the page. | |
WebTestPlugin | Provides a means to run code and access a WebTest before and after the Web performance test is run. This class must be inherited. | |
WebTestPluginReference | The WebTestPluginReference class encapsulates the metadata about a WebTestRequestPlugin and the parameter values to use when an instance of the WebTestRequestPlugin is created when the Web performance test that uses the WebTestRequestPlugin is run. | |
WebTestPluginReferenceCollection | Represents a serializable strongly typed container for Web performance test plug-in references. | |
WebTestRecorderPlugin | Plug-in interface for a Web performance test recorder. | |
WebTestRecorderPluginReference | Represents a Web performance test rule for a reference to an executable plug-in. | |
WebTestRecorderUtilities | Provides methods to parse requests. This class cannot be inherited. | |
WebTestRequest | Represents an HTTP request that will be sent to a Web server. | |
WebTestRequestCollection | A strongly typed container for Web performance test request headers. | |
WebTestRequestHeader | Represents an HTTP header. | |
WebTestRequestHeaderCollection | A serializable strongly typed container for Web performance test request headers. | |
WebTestRequestPlugin | Receives notifications before and after a request is processed. | |
WebTestRequestPluginConverter | Class to convert webtests from Visual Studio 2005. Not intended for use by user written code. | |
WebTestRequestPluginReference | The WebTestRequestPluginReference class encapsulates the metadata about a WebTestRequestPlugin and the parameter values to use when an instance of the WebTestRequestPlugin is created when the Web performance test that uses the WebTestRequestPlugin is run. | |
WebTestRequestPluginReferenceCollection | Represents a strongly typed container for Web performance test request plug-in references. | |
WebTestRequestResult | Class to contain all result information for a completed Web performance test request. | |
WebTestRequestStatistics | Used to track key information that is gathered when the request is run. | |
WebTestResponse | Represents an HTTP response. | |
WebTestResponseCodeConverter | Helper class that helps with conversions between enum values and strings. | |
WebTestResultComment | Represents the comment body of a Web performance test result. | |
WebTestResultCondition | Represents a Web performance test result condition. | |
WebTestResultDetails | Class to contain the result details of Web performance tests. | |
WebTestResultDetailsSerializer | Saves and loads a WebTestResultDetails to and from a file in binary format. | |
WebTestResultGroup | Abstracts a group of results in the Web performance test result, such as a loop or condition. | |
WebTestResultIteration | Represents the current iteration of a Web performance test. | |
WebTestResultLoop | Class to contain the loop result of a Web performance test. | |
WebTestResultLoopIteration | Class to contain the result of a Web performance test loop iteration. | |
WebTestResultPage | Retrieves a top-level page result. | |
WebTestResultTransaction | Stores the results of a transaction in a Web performance test. | |
WebTestResultUnit | Represents a page or a request object in the Web performance test result. | |
WebTestRuleBase | An abstract base class extended by rule and reference classes in the Microsoft.VisualStudio.TestTools.WebTesting namespace. | |
WebTestStoppedException | Represents the exception that is thrown when data binding is performed on a table with a unique AccessMethod when there are no more rows of data in the table. | |
WorkItemAttribute | Use this attribute to specify a work item that is associated with a test. |
Interfaces
Interface | Description | |
---|---|---|
IBinaryHttpBodyEditorPlugin | Provides an interface for a binary HTTP body plug-in. | |
IHttpBody | Provides a common interface for accessing an HTTP body. | |
IStringHttpBodyEditorPlugin | Provides an interface for a string HTTP body plug-in. |
Enumerations
Enumeration | Description | |
---|---|---|
ConditionalConstructType | Enumerates all possible conditional construct types. | |
ConditionalRuleType | Enumerates all possible condition rule types. | |
DataBindingAccessMethod | Enumeration for the access method that is used for data binding. | |
DataBindingSelectColumns | Specifies the column filters that are used for data binding. | |
ForLoopComparisonOperator | Enumerates all possible numeric comparison operators for the for loop conditional rule. | |
NumericalComparisonOperator | Enumerates the numeric comparison operators that are available. | |
Outcome | Describes the outcome of a Web performance test. | |
RequestType | Enumerates the request types that are available. | |
RuleExecutionOrder | Enumerates the possible order-of-execution for validation rules. | |
StringComparisonOperator | Enumerates the string comparison operators that are available. | |
ValidationLevel | Used to identify the importance of a validation rule that is run in a load test. | |
WebTestErrorType | Enumerates the types of errors that can be included in a WebTestError object. | |
WebTestExecutionInstruction | Used to denote how to handle an operation. | |
WebTestResponseCode | Enumerates the HTTP response codes that are defined in RFC 2616 for HTTP 1.1. | |
WebTestResultStatus | Enumeration for the status of a Web performance test result. |
See Also
Reference
Other Resources
Working with Web Tests Overview
Web Performance Test Editor Overview
How to: Run a Web Performance Test from the Command Line
How to: Create a Coded Web Performance Test
Walkthrough: Recording and Running a Web Performance Test