HttpClient Třída

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Zdroj:

HttpClient.cs

Poskytuje třídu pro odesílání požadavků HTTP a příjem odpovědí HTTP z prostředku identifikovaného identifikátorem URI.

public ref class HttpClient : System::Net::Http::HttpMessageInvoker

public class HttpClient : System.Net.Http.HttpMessageInvoker

type HttpClient = class
    inherit HttpMessageInvoker

Public Class HttpClient
Inherits HttpMessageInvoker

Dědičnost

Object

HttpMessageInvoker

HttpClient

Příklady

// 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

Poznámky

Další informace o tomto rozhraní API naleznete v tématu Doplňkové poznámky k rozhraní API pro HttpClient.

Konstruktory

Name	Description
HttpClient()	Inicializuje novou instanci HttpClient třídy pomocí HttpClientHandler , který je uvolněn, když je tato instance uvolněna.
HttpClient(HttpMessageHandler, Boolean)	Inicializuje novou instanci třídy s poskytnutou HttpClient obslužnou rutinou a určuje, zda má být obslužná rutina uvolněna při odstranění této instance.
HttpClient(HttpMessageHandler)	Inicializuje novou instanci HttpClient třídy se zadanou obslužnou rutinou. Obslužná rutina je uvolněna při odstranění této instance.

Vlastnosti

Name	Description
BaseAddress	Získá nebo nastaví základní adresu identifikátoru URI (Uniform Resource Identifier) internetového prostředku použitého při odesílání požadavků.
DefaultProxy	Získá nebo nastaví globální proxy server HTTP.
DefaultRequestHeaders	Získá hlavičky, které mají být odeslány s každou žádostí.
DefaultRequestVersion	Získá nebo nastaví výchozí verzi HTTP použitou pro následné požadavky provedené touto HttpClient instancí.
DefaultVersionPolicy	Získá nebo nastaví výchozí zásady verze pro implicitně vytvořené požadavky v metodách pohodlí, například GetAsync(String) a PostAsync(String, HttpContent).
MaxResponseContentBufferSize	Získá nebo nastaví maximální počet bajtů do vyrovnávací paměti při čtení obsahu odpovědi.
Timeout	Získá nebo nastaví časový rozsah čekání před časovým limitem požadavku.

Metody

Name	Description
CancelPendingRequests()	Zrušte všechny čekající požadavky na tuto instanci.
DeleteAsync(String, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.
DeleteAsync(String)	Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.
DeleteAsync(Uri, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.
DeleteAsync(Uri)	Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.
Dispose()	Uvolní nespravované prostředky a odstraní spravované prostředky používané nástrojem HttpMessageInvoker. (Zděděno od HttpMessageInvoker)
Dispose(Boolean)	Uvolní nespravované prostředky používané spravovanými HttpClient prostředky a volitelně zlikviduje spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetAsync(String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.
GetAsync(String, HttpCompletionOption, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP a tokenem zrušení jako asynchronní operací.
GetAsync(String, HttpCompletionOption)	Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operací.
GetAsync(String)	Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.
GetAsync(Uri, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP a tokenem zrušení jako asynchronní operací.
GetAsync(Uri, HttpCompletionOption)	Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operací.
GetAsync(Uri)	Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.
GetByteArrayAsync(String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(String)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(Uri, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(Uri)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetStreamAsync(String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako datový proud v asynchronní operaci.
GetStreamAsync(String)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako datový proud v asynchronní operaci.
GetStreamAsync(Uri, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako datový proud v asynchronní operaci.
GetStreamAsync(Uri)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako datový proud v asynchronní operaci.
GetStringAsync(String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetStringAsync(String)	Odešle požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetStringAsync(Uri, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetStringAsync(Uri)	Odešle požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
PatchAsync(String, HttpContent, CancellationToken)	Odešle požadavek PATCH s tokenem zrušení na identifikátor URI reprezentovaný jako řetězec jako asynchronní operace.
PatchAsync(String, HttpContent)	Odešle požadavek PATCH na identifikátor URI určený jako řetězec jako asynchronní operace.
PatchAsync(Uri, HttpContent, CancellationToken)	Odešle požadavek PATCH s tokenem zrušení jako asynchronní operací.
PatchAsync(Uri, HttpContent)	Odešle požadavek PATCH jako asynchronní operaci.
PostAsync(String, HttpContent, CancellationToken)	Odešle požadavek POST s tokenem zrušení jako asynchronní operací.
PostAsync(String, HttpContent)	Odešle požadavek POST na zadaný identifikátor URI jako asynchronní operaci.
PostAsync(Uri, HttpContent, CancellationToken)	Odešle požadavek POST s tokenem zrušení jako asynchronní operací.
PostAsync(Uri, HttpContent)	Odešle požadavek POST na zadaný identifikátor URI jako asynchronní operaci.
PutAsync(String, HttpContent, CancellationToken)	Odešle požadavek PUT s tokenem zrušení jako asynchronní operací.
PutAsync(String, HttpContent)	Odešle požadavek PUT na zadaný identifikátor URI jako asynchronní operaci.
PutAsync(Uri, HttpContent, CancellationToken)	Odešle požadavek PUT s tokenem zrušení jako asynchronní operací.
PutAsync(Uri, HttpContent)	Odešle požadavek PUT na zadaný identifikátor URI jako asynchronní operaci.
Send(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP se zadaným požadavkem a tokenem zrušení.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Odešle požadavek HTTP se zadaným požadavkem, možností dokončení a tokenem zrušení.
Send(HttpRequestMessage, HttpCompletionOption)	Odešle požadavek HTTP.
Send(HttpRequestMessage)	Odešle požadavek HTTP se zadaným požadavkem.
SendAsync(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP jako asynchronní operaci.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Odešle požadavek HTTP jako asynchronní operaci.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Odešle požadavek HTTP jako asynchronní operaci.
SendAsync(HttpRequestMessage)	Odešle požadavek HTTP jako asynchronní operaci.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Metody rozšíření

Name	Description
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)	HTTP GETOdešle požadavek na zadanou requestUri hodnotu a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní enumerovatelné operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	HTTP GET Odešle požadavek na zadanou requestUri hodnotu a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní enumerovatelné operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	HTTP GETOdešle požadavek na zadanou requestUri hodnotu a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní enumerovatelné operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)	HTTP GETOdešle požadavek na zadanou requestUri hodnotu a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní enumerovatelné operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	HTTP GETOdešle požadavek na zadanou requestUri hodnotu a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní enumerovatelné operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	HTTP GETOdešle požadavek na zadanou requestUri hodnotu a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní enumerovatelné operaci.
GetFromJsonAsync(HttpClient, String, Type, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní operaci.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Odešle požadavek PATCH na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Odešle požadavek PATCH na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek PATCH na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Odešle požadavek PATCH na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Odešle požadavek PATCH na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek PATCH na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Odešle požadavek POST na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Odešle požadavek POST na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek POST na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Odešle požadavek POST na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Odešle požadavek POST na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek POST na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Odešle požadavek PUT na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Odešle požadavek PUT na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek PUT na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Odešle požadavek PUT na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Odešle požadavek PUT na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Odešle požadavek PUT na zadaný identifikátor URI obsahující value serializovaný jako JSON v textu požadavku.

Viz také

• Pokyny pro používání HttpClient
• Ukázka HttpClient