HttpClient Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет класс для отправки HTTP-запросов и получения HTTP-ответов из ресурса, определяемого URI.
public ref class HttpClient : System::Net::Http::HttpMessageInvokerpublic class HttpClient : System.Net.Http.HttpMessageInvokertype HttpClient = class
inherit HttpMessageInvokerPublic Class HttpClient
Inherits HttpMessageInvoker- Наследование
Примеры
// 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
Комментарии
Дополнительные сведения об этом API см. в дополнительных примечаниях API для HttpClient.
Конструкторы
| Имя | Описание |
|---|---|
| HttpClient() |
Инициализирует новый экземпляр HttpClient класса с помощью HttpClientHandler удаления этого экземпляра. |
| HttpClient(HttpMessageHandler, Boolean) |
Инициализирует новый экземпляр HttpClient класса с предоставленным обработчиком и указывает, следует ли удалить этот обработчик при удалении этого экземпляра. |
| HttpClient(HttpMessageHandler) |
Инициализирует новый экземпляр HttpClient класса с указанным обработчиком. Обработчик удаляется при удалении этого экземпляра. |
Свойства
| Имя | Описание |
|---|---|
| BaseAddress |
Возвращает или задает базовый адрес универсального идентификатора ресурса (URI) ресурса Интернета, используемого при отправке запросов. |
| DefaultRequestHeaders |
Возвращает заголовки, которые должны отправляться с каждым запросом. |
| MaxResponseContentBufferSize |
Возвращает или задает максимальное количество байтов для буфера при чтении содержимого ответа. |
| Timeout |
Возвращает или задает интервал времени ожидания до истечения времени ожидания запроса. |
Методы
| Имя | Описание |
|---|---|
| CancelPendingRequests() |
Отмена всех ожидающих запросов на этом экземпляре. |
| DeleteAsync(String, CancellationToken) |
Отправьте запрос DELETE в указанный URI с маркером отмены в качестве асинхронной операции. |
| DeleteAsync(String) |
Отправьте запрос DELETE в указанный универсальный код ресурса (URI) в качестве асинхронной операции. |
| DeleteAsync(Uri, CancellationToken) |
Отправьте запрос DELETE в указанный URI с маркером отмены в качестве асинхронной операции. |
| DeleteAsync(Uri) |
Отправьте запрос DELETE в указанный универсальный код ресурса (URI) в качестве асинхронной операции. |
| Dispose() |
Освобождает неуправляемые ресурсы и удаляет управляемые ресурсы, используемые параметром HttpMessageInvoker. (Унаследовано от HttpMessageInvoker) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые HttpClient и при необходимости удаляет управляемые ресурсы. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetAsync(String, CancellationToken) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) с маркером отмены в виде асинхронной операции. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP и маркером отмены в качестве асинхронной операции. |
| GetAsync(String, HttpCompletionOption) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP в качестве асинхронной операции. |
| GetAsync(String) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции. |
| GetAsync(Uri, CancellationToken) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) с маркером отмены в виде асинхронной операции. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP и маркером отмены в качестве асинхронной операции. |
| GetAsync(Uri, HttpCompletionOption) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP в качестве асинхронной операции. |
| GetAsync(Uri) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции. |
| GetByteArrayAsync(String) |
Отправляет запрос GET в указанный универсальный код ресурса (URI) и возвращает текст ответа в виде массива байтов в асинхронной операции. |
| GetByteArrayAsync(Uri) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) и верните текст ответа в виде массива байтов в асинхронной операции. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetStreamAsync(String) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) и верните текст ответа в виде потока в асинхронной операции. |
| GetStreamAsync(Uri) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) и верните текст ответа в виде потока в асинхронной операции. |
| GetStringAsync(String) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) и верните текст ответа в виде строки в асинхронной операции. |
| GetStringAsync(Uri) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) и верните текст ответа в виде строки в асинхронной операции. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| PatchAsync(String, HttpContent, CancellationToken) |
Отправляет запрос PATCH с маркером отмены в URI, представленный как строка в виде асинхронной операции. |
| PatchAsync(String, HttpContent) |
Отправляет запрос PATCH в универсальный код ресурса (URI), назначенный как строка в качестве асинхронной операции. |
| PatchAsync(Uri, HttpContent, CancellationToken) |
Отправляет запрос PATCH с маркером отмены в виде асинхронной операции. |
| PatchAsync(Uri, HttpContent) |
Отправляет запрос PATCH в виде асинхронной операции. |
| PostAsync(String, HttpContent, CancellationToken) |
Отправьте запрос POST с маркером отмены в виде асинхронной операции. |
| PostAsync(String, HttpContent) |
Отправьте запрос POST в указанный URI в качестве асинхронной операции. |
| PostAsync(Uri, HttpContent, CancellationToken) |
Отправьте запрос POST с маркером отмены в виде асинхронной операции. |
| PostAsync(Uri, HttpContent) |
Отправьте запрос POST в указанный URI в качестве асинхронной операции. |
| PutAsync(String, HttpContent, CancellationToken) |
Отправьте запрос PUT с маркером отмены в виде асинхронной операции. |
| PutAsync(String, HttpContent) |
Отправьте запрос PUT в указанный универсальный код ресурса (URI) в виде асинхронной операции. |
| PutAsync(Uri, HttpContent, CancellationToken) |
Отправьте запрос PUT с маркером отмены в виде асинхронной операции. |
| PutAsync(Uri, HttpContent) |
Отправьте запрос PUT в указанный универсальный код ресурса (URI) в виде асинхронной операции. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Отправка HTTP-запроса в виде асинхронной операции. |
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Отправка HTTP-запроса в виде асинхронной операции. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Отправка HTTP-запроса в виде асинхронной операции. |
| SendAsync(HttpRequestMessage) |
Отправка HTTP-запроса в виде асинхронной операции. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |