HttpResponseMessage Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un mensaje de respuesta HTTP incluido el código de estado y los datos.
public ref class HttpResponseMessage : IDisposable
public class HttpResponseMessage : IDisposable
type HttpResponseMessage = class
interface IDisposable
Public Class HttpResponseMessage
Implements IDisposable
- Herencia
-
HttpResponseMessage
- Implementaciones
Ejemplos
// 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
En el ejemplo de código anterior se usa un async Task Main()
punto de entrada. Esa característica requiere C# 7.1 o posterior.
Comentarios
Una manera común de obtener un HttpResponseMessage elemento es de uno de los HttpClient.SendAsync(HttpRequestMessage) métodos .
Constructores
HttpResponseMessage() |
Inicializa una nueva instancia de la clase HttpResponseMessage. |
HttpResponseMessage(HttpStatusCode) |
Inicializa una instancia nueva de la clase HttpResponseMessage con un StatusCode específico. |
Propiedades
Content |
Obtiene o establece el contenido de un mensaje de respuesta HTTP. |
Headers |
Obtiene la colección de encabezados de respuesta HTTP. |
IsSuccessStatusCode |
Obtiene un valor que indica si la respuesta HTTP se realizó correctamente. |
ReasonPhrase |
Obtiene o establece la frase de motivo que suelen enviar los servidores junto con el código de estado. |
RequestMessage |
Obtiene o establece el mensaje de solicitud que condujo a este mensaje de respuesta. |
StatusCode |
Obtiene o establece el código de estado de la respuesta HTTP. |
TrailingHeaders |
Obtiene la colección de encabezados finales incluidos en una respuesta HTTP. |
Version |
Obtiene o establece la versión del mensaje HTTP. |
Métodos
Dispose() |
Libera los recursos no administrados y desecha los recursos no administrados que usa HttpResponseMessage. |
Dispose(Boolean) |
Libera los recursos no administrados que usa el objeto HttpResponseMessage y, de forma opcional, desecha los recursos administrados. |
EnsureSuccessStatusCode() |
Inicia una excepción si la propiedad IsSuccessStatusCode para la respuesta HTTP es |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. |
Métodos de extensión
ToMessage(HttpResponseMessage) |
Crea una instancia de Message a partir de una instancia de HttpResponseMessage. |