ExtractHttpHeader Class

Used to extract an HTTP header value from the response and place the value of the header into the WebTestContext.

Inheritance Hierarchy

Object
  Microsoft.VisualStudio.TestTools.WebTesting.ExtractionRule
    Microsoft.VisualStudio.TestTools.WebTesting.Rules.ExtractHttpHeader

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

Syntax

'Declaration
Public Class ExtractHttpHeader _
    Inherits ExtractionRule
public class ExtractHttpHeader : ExtractionRule
public ref class ExtractHttpHeader : public ExtractionRule
type ExtractHttpHeader =  
    class 
        inherit ExtractionRule 
    end
public class ExtractHttpHeader extends ExtractionRule

The ExtractHttpHeader type exposes the following members.

Constructors

  Name Description
Public method ExtractHttpHeader Initializes a new instance of the ExtractHttpHeader class.

Top

Properties

  Name Description
Public property ContextParameterName Gets or sets the context name of the extracted property. (Inherited from ExtractionRule.)
Public property Header Gets or sets a value representing the name of the header whose value is to be extracted.
Public property Required Gets or sets a value that indicates whether the request fails if the header does not exist.
Public property RuleDescription Obsolete. This method is no longer used. Use the DisplayNameAttribute on the class to set a description for this rule. (Inherited from ExtractionRule.)
Public property RuleName Obsolete. This method is no longer used. Use the DisplayNameAttribute on the class to set a display name for this rule. (Inherited from ExtractionRule.)

Top

Methods

  Name Description
Public method Equals Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public method Extract Extracts the value of an HTTP header from the response and places the value and context parameter name into the WebTestContext. (Overrides ExtractionRule.Extract(Object, ExtractionEventArgs).)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as the default hash function. (Inherited from Object.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

Consider the following HTTP headers:

Content-Length : 2036

Cache-Control : private

Content-Type : text/html; charset=utf-8

If Header is set to Content-Length, this rule will extract 2036 from the headers.

Thread Safety

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

See Also

Reference

Microsoft.VisualStudio.TestTools.WebTesting.Rules Namespace

Other Resources

Working with Web Tests

Coding a custom extraction rule for a web performance test

[retired] How to: Add an Extraction Rule to a Web Performance Test