Skip to main content
.NET Framework Class Library
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)
Syntax
Public Overridable ReadOnly Property Headers As WebHeaderCollection
public virtual WebHeaderCollection Headers { get; }
public:
virtual property WebHeaderCollection^ Headers {
	WebHeaderCollection^ get ();
}
abstract Headers : WebHeaderCollection
override Headers : WebHeaderCollection

Property Value

Type: System.Net..::.WebHeaderCollection
An instance of the WebHeaderCollection class that contains header values associated with this response.
Exceptions
ExceptionCondition
NotSupportedException

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

Remarks

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.

Examples

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.Headers.Count; ++i)  
		    Console.WriteLine("\nHeader Name:{0}, Header value :{1}",myWebResponse.Headers.Keys[i],myWebResponse.Headers[i]); 

         // 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 its key , associated with the response object.
      for ( int i = 0; i < myWebResponse->Headers->Count; ++i )
         Console::WriteLine( "\nHeader Name: {0}, Header value : {1}", myWebResponse->Headers->Keys[ i ], myWebResponse->Headers[ i ] );

      // Release resources of response object.
      myWebResponse->Close();


Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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