This documentation is archived and is not being maintained.

HttpWebResponse::GetResponseHeader Method

Gets the contents of a header that was returned with the response.

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

String^ GetResponseHeader(
	String^ headerName


Type: System::String
The header value to return.

Return Value

Type: System::String
The contents of the specified header.


The current instance has been disposed.

Use GetResponseHeader to retrieve the contents of particular headers. You must specify which header you want to return.

This example creates a Web request and queries for a response. If the site requires authentication, this example will respond with a challenge string. This string is extracted using GetResponseHeader.

void GetPage( String^ url )
      Uri^ ourUri = gcnew Uri( url );
      // Creates an HttpWebRequest for the specified URL.
      HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( ourUri ) );
      HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
      Console::WriteLine( "\nThe server did not issue any challenge.  Please try again with a protected resource URL." );
      // Releases the resources of the response.
   catch ( WebException^ e ) 
      HttpWebResponse^ response = (HttpWebResponse^)( e->Response );
      if ( response != nullptr )
         if ( response->StatusCode == HttpStatusCode::Unauthorized )
            String^ challenge = nullptr;
            challenge = response->GetResponseHeader( "WWW-Authenticate" );
            if ( challenge != nullptr )
                        Console::WriteLine( "\nThe following challenge was raised by the server: {0}", challenge );
            Console::WriteLine( "\nThe following WebException was raised : {0}", e->Message );
         Console::WriteLine( "\nResponse Received from server was 0" );
   catch ( Exception^ e ) 
      Console::WriteLine( "\nThe following Exception was raised : {0}", e->Message );

.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

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.