Edit

Share via


HttpResponseMessage Class

Definition

Represents a HTTP response message including the status code and data.

C#
public class HttpResponseMessage : IDisposable
Inheritance
HttpResponseMessage
Implements

Examples

C#
// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
static readonly HttpClient client = new HttpClient();

static async Task Main()
{
    // Call asynchronous network methods in a try/catch block to handle exceptions.
    try
    {
        using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
        response.EnsureSuccessStatusCode();
        string responseBody = await response.Content.ReadAsStringAsync();
        // Above three lines can be replaced with new helper method below
        // string responseBody = await client.GetStringAsync(uri);

        Console.WriteLine(responseBody);
    }
    catch (HttpRequestException e)
    {
        Console.WriteLine("\nException Caught!");
        Console.WriteLine("Message :{0} ", e.Message);
    }
}

The preceding code example uses an async Task Main() entry point. That feature requires C# 7.1 or later.

Remarks

A common way to get an HttpResponseMessage is from one of the HttpClient.SendAsync(HttpRequestMessage) methods.

Constructors

HttpResponseMessage()

Initializes a new instance of the HttpResponseMessage class.

HttpResponseMessage(HttpStatusCode)

Initializes a new instance of the HttpResponseMessage class with a specific StatusCode.

Properties

Content

Gets or sets the content of a HTTP response message.

Headers

Gets the collection of HTTP response headers.

IsSuccessStatusCode

Gets a value that indicates if the HTTP response was successful.

ReasonPhrase

Gets or sets the reason phrase which typically is sent by servers together with the status code.

RequestMessage

Gets or sets the request message which led to this response message.

StatusCode

Gets or sets the status code of the HTTP response.

TrailingHeaders

Gets the collection of trailing headers included in an HTTP response.

Version

Gets or sets the HTTP message version.

Methods

Dispose()

Releases the unmanaged resources and disposes of unmanaged resources used by the HttpResponseMessage.

Dispose(Boolean)

Releases the unmanaged resources used by the HttpResponseMessage and optionally disposes of the managed resources.

EnsureSuccessStatusCode()

Throws an exception if the IsSuccessStatusCode property for the HTTP response is false.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

Extension Methods

ToMessage(HttpResponseMessage)

Creates a Message instance from an HttpResponseMessage instance.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0