WebRequest::Headers Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

When overridden in a descendant class, gets or sets the collection of header name/value pairs associated with the request.

Namespace:   System.Net
Assembly:  System (in System.dll)

public:
property WebHeaderCollection^ Headers {
	virtual WebHeaderCollection^ get();
	virtual void set(WebHeaderCollection^ value);
}

Property Value

Type: System.Net::WebHeaderCollection^

A WebHeaderCollection containing the header name/value pairs associated with this request.

Exception Condition
NotImplementedException

Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

The Headers property contains a WebHeaderCollection instance containing the header information to send to the Internet resource.

System_CAPS_noteNote

The WebRequest class is an abstract class. The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest::Create method. For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

The following example displays the header name/value pairs associated with this request.

// Create a new request to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.contoso.com" );

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Release the resources of response object.
myWebResponse->Close();
Console::WriteLine( "\nThe HttpHeaders are \n {0}", myWebRequest->Headers );

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: