HttpClient Klasa

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Źródło:

HttpClient.cs

Udostępnia klasę do wysyłania żądań HTTP i odbierania odpowiedzi HTTP z zasobu zidentyfikowanego przez identyfikator URI.

C#

public class HttpClient : System.Net.Http.HttpMessageInvoker

Dziedziczenie

Object

HttpMessageInvoker

HttpClient

Przykłady

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

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla klienta HttpClient.

Konstruktory

HttpClient()	Inicjuje HttpClient nowe wystąpienie klasy przy użyciu HttpClientHandler klasy, która jest usuwana po usunięciu tego wystąpienia.
HttpClient(HttpMessageHandler)	Inicjuje HttpClient nowe wystąpienie klasy za pomocą określonej procedury obsługi. Procedura obsługi jest usuwana po usunięciu tego wystąpienia.
HttpClient(HttpMessageHandler, Boolean)	Inicjuje HttpClient nowe wystąpienie klasy z podaną procedurą obsługi i określa, czy ta procedura obsługi powinna zostać usunięta po usunięciu tego wystąpienia.

Właściwości

BaseAddress	Pobiera lub ustawia podstawowy adres identyfikatora URI zasobu internetowego używanego podczas wysyłania żądań.
DefaultProxy	Pobiera lub ustawia globalny serwer proxy HTTP.
DefaultRequestHeaders	Pobiera nagłówki, które powinny być wysyłane z każdym żądaniem.
DefaultRequestVersion	Pobiera lub ustawia domyślną wersję HTTP używaną w kolejnych żądaniach wysyłanych przez to HttpClient wystąpienie.
DefaultVersionPolicy	Pobiera lub ustawia domyślne zasady wersji dla niejawnie utworzonych żądań w metodach wygody, na przykład GetAsync(String) i PostAsync(String, HttpContent).
MaxResponseContentBufferSize	Pobiera lub ustawia maksymalną liczbę bajtów do buforu podczas odczytywania zawartości odpowiedzi.
Timeout	Pobiera lub ustawia przedział czasu oczekiwania przed upływem limitu czasu żądania.

Metody

CancelPendingRequests()	Anuluj wszystkie oczekujące żądania w tym wystąpieniu.
DeleteAsync(String)	Wyślij żądanie USUŃ do określonego identyfikatora Uri jako operację asynchroniczną.
DeleteAsync(String, CancellationToken)	Wyślij żądanie DELETE do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.
DeleteAsync(Uri)	Wyślij żądanie USUŃ do określonego identyfikatora Uri jako operację asynchroniczną.
DeleteAsync(Uri, CancellationToken)	Wyślij żądanie DELETE do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.
Dispose()	Zwalnia niezarządzane zasoby i usuwa zarządzane zasoby używane przez program HttpMessageInvoker. (Odziedziczone po HttpMessageInvoker)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez HttpClient program i opcjonalnie usuwa zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetAsync(String)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri jako operację asynchroniczną.
GetAsync(String, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.
GetAsync(String, HttpCompletionOption)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operacją asynchroniczną.
GetAsync(String, HttpCompletionOption, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną.
GetAsync(Uri)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri jako operację asynchroniczną.
GetAsync(Uri, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.
GetAsync(Uri, HttpCompletionOption)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operacją asynchroniczną.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną.
GetByteArrayAsync(String)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetByteArrayAsync(String, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetByteArrayAsync(Uri)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetByteArrayAsync(Uri, CancellationToken)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetStreamAsync(String)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.
GetStreamAsync(String, CancellationToken)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.
GetStreamAsync(Uri)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.
GetStreamAsync(Uri, CancellationToken)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.
GetStringAsync(String)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
GetStringAsync(String, CancellationToken)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
GetStringAsync(Uri)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
GetStringAsync(Uri, CancellationToken)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
PatchAsync(String, HttpContent)	Wysyła żądanie PATCH do identyfikatora URI wyznaczonego jako ciąg jako operację asynchroniczną.
PatchAsync(String, HttpContent, CancellationToken)	Wysyła żądanie PATCH z tokenem anulowania do identyfikatora URI reprezentowanego jako ciąg jako operacja asynchroniczna.
PatchAsync(Uri, HttpContent)	Wysyła żądanie PATCH jako operację asynchroniczną.
PatchAsync(Uri, HttpContent, CancellationToken)	Wysyła żądanie PATCH z tokenem anulowania jako operacją asynchroniczną.
PostAsync(String, HttpContent)	Wyślij żądanie WYŚLIJ do określonego identyfikatora Uri jako operację asynchroniczną.
PostAsync(String, HttpContent, CancellationToken)	Wyślij żądanie POST z tokenem anulowania jako operacją asynchroniczną.
PostAsync(Uri, HttpContent)	Wyślij żądanie WYŚLIJ do określonego identyfikatora Uri jako operację asynchroniczną.
PostAsync(Uri, HttpContent, CancellationToken)	Wyślij żądanie POST z tokenem anulowania jako operacją asynchroniczną.
PutAsync(String, HttpContent)	Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.
PutAsync(String, HttpContent, CancellationToken)	Wyślij żądanie PUT z tokenem anulowania jako operacją asynchroniczną.
PutAsync(Uri, HttpContent)	Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.
PutAsync(Uri, HttpContent, CancellationToken)	Wyślij żądanie PUT z tokenem anulowania jako operacją asynchroniczną.
Send(HttpRequestMessage)	Wysyła żądanie HTTP z określonym żądaniem.
Send(HttpRequestMessage, CancellationToken)	Wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania.
Send(HttpRequestMessage, HttpCompletionOption)	Wysyła żądanie HTTP.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Wysyła żądanie HTTP z określonym żądaniem, opcją ukończenia i tokenem anulowania.
SendAsync(HttpRequestMessage)	Wyślij żądanie HTTP jako operację asynchroniczną.
SendAsync(HttpRequestMessage, CancellationToken)	Wyślij żądanie HTTP jako operację asynchroniczną.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Wyślij żądanie HTTP jako operację asynchroniczną.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Wyślij żądanie HTTP jako operację asynchroniczną.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Metody rozszerzania

DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	HTTP GET Wysyła żądanie do określonego requestUri elementu i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji wyliczenia asynchronicznego.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	HTTP GETWysyła żądanie do określonego requestUri elementu i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji wyliczenia asynchronicznego.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)	HTTP GETWysyła żądanie do określonego requestUri elementu i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji wyliczenia asynchronicznego.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	HTTP GETWysyła żądanie do określonego requestUri elementu i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji wyliczenia asynchronicznego.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	HTTP GETWysyła żądanie do określonego requestUri elementu i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji wyliczenia asynchronicznego.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)	HTTP GETWysyła żądanie do określonego requestUri elementu i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji wyliczenia asynchronicznego.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync(HttpClient, String, Type, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Wysyła żądanie POST do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie POST do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Wysyła żądanie POST do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Wysyła żądanie POST do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Wysyła żądanie POST do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Wysyła żądanie POST do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Wyślij żądanie PUT do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Wyślij żądanie PUT do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Wyślij żądanie PUT do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Wyślij żądanie PUT do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Wyślij żądanie PUT do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Wyślij żądanie PUT do określonego identyfikatora URI zawierającego value serializowany kod JSON w treści żądania.

Dotyczy

Zobacz też

• Wskazówki dotyczące korzystania z klienta HttpClient
• Przykład httpclient