HttpResponseMessage Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет ответное сообщение HTTP, включая код и данные о состоянии.
public ref class HttpResponseMessage : IDisposable
public class HttpResponseMessage : IDisposable
type HttpResponseMessage = class
interface IDisposable
Public Class HttpResponseMessage
Implements IDisposable
- Наследование
-
HttpResponseMessage
- Реализации
Примеры
// 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
В приведенном выше примере кода используется async Task Main()
точка входа. Для этой функции требуется C# 7.1 или более поздней версии.
Комментарии
Распространенный HttpResponseMessage способ получения — из одного из HttpClient.SendAsync(HttpRequestMessage) методов.
Конструкторы
HttpResponseMessage() |
Инициализирует новый экземпляр класса HttpResponseMessage. |
HttpResponseMessage(HttpStatusCode) |
Инициализирует новый экземпляр класса HttpResponseMessage с конкретным StatusCode. |
Свойства
Content |
Возвращает или задает содержимое ответного HTTP-сообщения. |
Headers |
Возвращает коллекцию заголовков HTTP-ответа. |
IsSuccessStatusCode |
Возвращает значение, указывающее, завершился ли успешно HTTP-ответ. |
ReasonPhrase |
Возвращает или задает фразу причины, которая обычно отправляется серверами вместе с кодом состояния. |
RequestMessage |
Возвращает или задает сообщение запроса, которое привело к получению этого ответного сообщения. |
StatusCode |
Возвращает или задает код состояния HTTP-ответа. |
TrailingHeaders |
Возвращает коллекцию конечных заголовков, содержащихся в ответе HTTP. |
Version |
Возвращает или задает версию HTTP-сообщения. |
Методы
Dispose() |
Освобождает неуправляемые ресурсы и удаляет неуправляемые ресурсы, используемые объектом HttpResponseMessage. |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом HttpResponseMessage, и опционально удаляет управляемые ресурсы. |
EnsureSuccessStatusCode() |
Вызывает исключение, если свойство IsSuccessStatusCode для HTTP-ответа имеет значение |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. |
Методы расширения
ToMessage(HttpResponseMessage) |
Создает экземпляр Message из экземпляра HttpResponseMessage. |