HttpWebResponse.GetResponseHeader Method

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

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

Public Function GetResponseHeader ( _
	headerName As String _
) As String
Dim instance As HttpWebResponse
Dim headerName As String
Dim returnValue As String

returnValue = instance.GetResponseHeader(headerName)
public String GetResponseHeader (
	String headerName
public function GetResponseHeader (
	headerName : String
) : String



The header value to return.

Return Value

The contents of the specified header.

Exception typeCondition


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.

Public Shared Sub GetPage(url As [String])
        Dim ourUri As New Uri(url)
        ' Creates an HttpWebRequest for the specified URL. 
        Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(ourUri), HttpWebRequest)
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        Console.WriteLine(ControlChars.NewLine + "The server did not issue any challenge.  Please try again with a protected resource URL.")
        ' Releases the resources of the response.
    Catch e As WebException
        Dim response As HttpWebResponse = CType(e.Response, HttpWebResponse)
        If Not (response Is Nothing) Then
            If response.StatusCode = HttpStatusCode.Unauthorized Then
                Dim challenge As String = Nothing
                challenge = response.GetResponseHeader("WWW-Authenticate")
                If Not (challenge Is Nothing) Then
                    Console.WriteLine(ControlChars.NewLine + "The following challenge was raised by the server:{0}", challenge)
                End If
                Console.WriteLine(ControlChars.NewLine + "The following exception was raised : {0}", e.Message)
            End If
            Console.WriteLine(ControlChars.NewLine + "Response Received from server was null")
        End If 
    Catch e As Exception
        Console.WriteLine(ControlChars.NewLine + "The following exception was raised : {0}", e.Message)
    End Try
End Sub 

    public static void GetPage(String url)
        try {
            Uri ourUri = new Uri(url);
            // Creates an HttpWebRequest for the specified URL. 
            HttpWebRequest myHttpWebRequest = (HttpWebRequest)
            HttpWebResponse myHttpWebResponse = (HttpWebResponse)
            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.get_Response();
            if (response != null) {
                if (response.get_StatusCode().Equals(HttpStatusCode.
                    Unauthorized)) {
                    String challenge = null;
                    challenge = response.GetResponseHeader("WWW-Authenticate");
                    if (challenge != null) {
                        Console.WriteLine("\nThe following challenge was "
                            + "raised by the server:{0}", challenge);
                else {
                    Console.WriteLine("\nThe following WebException "
                        + "was raised : {0}", e.get_Message());
            else {
                Console.WriteLine("\nResponse Received from server was null");
        catch (System.Exception e) {
            Console.WriteLine("\nThe following Exception was raised : {0}",
    } //GetPage
} //HttpWebResponseSnippet

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