Export (0) Print
Expand All

WebResponse.Headers Property

When overridden in a derived class, gets a collection of header name-value pairs associated with this request.

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

'Declaration
Public Overridable ReadOnly Property Headers As WebHeaderCollection
'Usage
Dim instance As WebResponse
Dim value As WebHeaderCollection

value = instance.Headers

/** @property */
public WebHeaderCollection get_Headers ()

public function get Headers () : WebHeaderCollection

Property Value

An instance of the WebHeaderCollection class that contains header values associated with this response.

Exception typeCondition

NotSupportedException

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

The Headers property contains the name-value header pairs returned in the response.

NoteNote

The WebResponse class is an abstract class. The actual behavior of WebResponse instances at run time is determined by the descendant class returned by WebRequest.GetResponse. For more information about default values and exceptions, please see the documentation for the descendant classes, such as HttpWebResponse and FileWebResponse.

The following example displays all of the header name-value pairs returned in the WebResponse.


    ' Create a 'WebRequest' object with the specified url     
    Dim myWebRequest As WebRequest = WebRequest.Create("www.contoso.com")
    
    ' Send the 'WebRequest' and wait for response.
    Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
    
    ' Display all the Headers present in the response received from the URl.
    Console.WriteLine(ControlChars.Cr + "The following headers were received in the response")
    
    ' Headers property is a 'WebHeaderCollection'. Use it's properties to traverse the collection and display each header
    Dim i As Integer
    
    While i < myWebResponse.Headers.Count
        Console.WriteLine(ControlChars.Cr + "Header Name:{0}, Header value :{1}", myWebResponse.Headers.Keys(i), myWebResponse.Headers(i))
i = i + 1
    End While

    ' Release resources of response object.
    myWebResponse.Close()
    

// Create a 'WebRequest' object with the specified url.     
WebRequest myWebRequest = WebRequest.Create("http://www.contoso.com");
// Send the 'WebRequest' and wait for response.
WebResponse myWebResponse = myWebRequest.GetResponse();
// Display all the Headers present in the response received from 
// the URl.
Console.WriteLine("\nThe following headers were received in the " 
    + "response");
// Display each header and it's key , associated with the response 
// object.
for (int i = 0; i < myWebResponse.get_Headers().get_Count(); ++i) {
    Console.WriteLine("\nHeader Name:{0}, Header value :{1}",
        myWebResponse.get_Headers().get_Keys().get_Item(i), 
        myWebResponse.get_Headers().get_Item(i));
}
// Release resources of response object.
myWebResponse.Close();

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft