HttpResponseMessage Classe

Referência

Definição

Namespace:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Origem:: HttpResponseMessage.cs

Origem:: HttpResponseMessage.cs

Origem:: HttpResponseMessage.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma mensagem de resposta HTTP incluindo o código de status e os dados.

public ref class HttpResponseMessage : IDisposable

public class HttpResponseMessage : IDisposable

type HttpResponseMessage = class
    interface IDisposable

Public Class HttpResponseMessage
Implements IDisposable

Herança: Object
HttpResponseMessage

Implementações: IDisposable

Exemplos

// 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);
    }
}

open System.Net.Http

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
let client = new HttpClient()

let main =
    task {
        // Call asynchronous network methods in a try/catch block to handle exceptions.
        try
            use! response = client.GetAsync "http://www.contoso.com/"
            response.EnsureSuccessStatusCode() |> ignore
            let! responseBody = response.Content.ReadAsStringAsync()
            // Above three lines can be replaced with new helper method below
            // let! responseBody = client.GetStringAsync uri

            printfn $"{responseBody}"
        with
        | :? HttpRequestException as e ->
            printfn "\nException Caught!"
            printfn $"Message :{e.Message} "
    }

main.Wait()

' HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
Shared ReadOnly client As HttpClient = New HttpClient()

Private Shared Async Function Main() As Task
    ' Call asynchronous network methods in a try/catch block to handle exceptions.
    Try
        Using response As HttpResponseMessage = Await client.GetAsync("http://www.contoso.com/")
            response.EnsureSuccessStatusCode()
            Dim responseBody As String = Await response.Content.ReadAsStringAsync()
            ' Above three lines can be replaced with new helper method below
            ' Dim responseBody As String = Await client.GetStringAsync(uri)

            Console.WriteLine(responseBody)
        End Using
    Catch e As HttpRequestException
        Console.WriteLine(Environment.NewLine & "Exception Caught!")
        Console.WriteLine("Message :{0} ", e.Message)
    End Try
End Function

O exemplo de código anterior usa um async Task Main() ponto de entrada. Esse recurso requer o C# 7.1 ou posterior.

Comentários

Uma maneira comum de obter um HttpResponseMessage é de um dos HttpClient.SendAsync(HttpRequestMessage) métodos.

Construtores

HttpResponseMessage()	Inicializa uma nova instância da classe HttpResponseMessage.
HttpResponseMessage(HttpStatusCode)	Inicializa uma nova instância da classe HttpResponseMessage com um StatusCode específico.

Propriedades

Content	Obtém ou define o conteúdo de uma mensagem de resposta HTTP.
Headers	Obtém a coleção de cabeçalhos de resposta HTTP.
IsSuccessStatusCode	Obtém um valor que indica se a resposta HTTP foi bem-sucedida.
ReasonPhrase	Obtém ou define a frase de motivo que geralmente é enviada por servidores juntamente com o código de status.
RequestMessage	Obtém ou define a mensagem de solicitação que levou a essa mensagem de resposta.
StatusCode	Obtém ou define o código de status da resposta HTTP.
TrailingHeaders	Obtém a coleção de cabeçalhos à direita incluídos em uma resposta HTTP.
Version	Obtém ou define a versão da mensagem HTTP.

Métodos

Dispose()	Libera os recursos não gerenciados e descarta os recursos não gerenciados usados pelo HttpResponseMessage.
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo HttpResponseMessage e, opcionalmente, descarta os recursos gerenciados.
EnsureSuccessStatusCode()	Gera uma exceção se a propriedade IsSuccessStatusCode da resposta HTTP for `false`.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual.

Métodos de Extensão

ToMessage(HttpResponseMessage)

Cria uma instância de Message de uma instância de HttpResponseMessage.

Aplica-se a

Compartilhar via