HttpClient Třída

Reference

Definice

Obor názvů:: System.Net.Http

Sestavení:: System.Net.Http.dll

Sestavení:: netstandard.dll

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 najdete v tématu Doplňkové poznámky k rozhraní API pro HttpClient.

Konstruktory

HttpClient()	Inicializuje novou instanci HttpClient třídy pomocí HttpClientHandler , který je uvolněn 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, když je tato instance uvolněna.
HttpClient(HttpMessageHandler, Boolean)	Inicializuje novou instanci HttpClient třídy se zadanou obslužnou rutinou a určuje, zda má být tato obslužná rutina odstraněna při odstranění této instance.

Vlastnosti

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é by měly být odeslány s každou žádostí.
DefaultRequestVersion	Získá nebo nastaví výchozí verzi PROTOKOLU HTTP použité v následných požadavcích provedených touto HttpClient instancí.
DefaultVersionPolicy	Získá nebo nastaví výchozí zásady verze pro implicitně vytvořené požadavky v praktických metodách, GetAsync(String) například a PostAsync(String, HttpContent).
MaxResponseContentBufferSize	Získá nebo nastaví maximální počet bajtů vyrovnávací paměti při čtení obsahu odpovědi.
Timeout	Získá nebo nastaví časový rozsah na čekání před vypršením časového limitu požadavku.

Metody

CancelPendingRequests()	Zrušit všechny požadavky čekající na tuto instanci.
DeleteAsync(String)	Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.
DeleteAsync(String, CancellationToken)	Odešlete 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.
DeleteAsync(Uri, CancellationToken)	Odešlete požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.
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é a HttpClient volitelně odstraní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetAsync(String)	Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.
GetAsync(String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI s 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í operace.
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(Uri)	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)	Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operace.
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í.
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(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(Uri)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(Uri, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetStreamAsync(String)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStreamAsync(String, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStreamAsync(Uri)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStreamAsync(Uri, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako stream v asynchronní operaci.
GetStringAsync(String)	Odešlete požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetStringAsync(String, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetStringAsync(Uri)	Odešlete požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetStringAsync(Uri, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vrátí text odpovědi jako řetězec v asynchronní operaci.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
PatchAsync(String, HttpContent)	Odešle požadavek PATCH na identifikátor URI určený jako řetězec jako asynchronní operace.
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(Uri, HttpContent)	Odešle požadavek PATCH jako asynchronní operaci.
PatchAsync(Uri, HttpContent, CancellationToken)	Odešle požadavek PATCH s tokenem zrušení jako asynchronní operace.
PostAsync(String, HttpContent)	Odešle požadavek POST na zadaný identifikátor URI jako asynchronní operaci.
PostAsync(String, HttpContent, CancellationToken)	Odešle požadavek POST s tokenem zrušení jako asynchronní operaci.
PostAsync(Uri, 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í operaci.
PutAsync(String, HttpContent)	Odešle požadavek PUT na zadaný identifikátor URI jako asynchronní operaci.
PutAsync(String, HttpContent, CancellationToken)	Odešle požadavek PUT s tokenem zrušení jako asynchronní operaci.
PutAsync(Uri, 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í operaci.
Send(HttpRequestMessage)	Odešle požadavek HTTP se zadaným požadavkem.
Send(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP se zadaným požadavkem a tokenem zrušení.
Send(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP se zadaným požadavkem a tokenem zrušení. (Zděděno od HttpMessageInvoker)
Send(HttpRequestMessage, HttpCompletionOption)	Odešle požadavek HTTP.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Odešle požadavek HTTP se zadaným požadavkem, možností dokončení a tokenem zrušení.
SendAsync(HttpRequestMessage)	Odešle požadavek HTTP jako asynchronní operaci.
SendAsync(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP jako asynchronní operaci.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Odešle požadavek HTTP jako asynchronní operaci.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	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í

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 těla 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 těla odpovědi jako JSON v asynchronní operaci.
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI a vrátí hodnotu, která je výsledkem deserializace těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla odpovědi jako JSON v asynchronní operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	`HTTP GET` Odešle požadavek zadanému `requestUri` a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní výčtové operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	`HTTP GET`Odešle požadavek zadanému `requestUri` a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní výčtové operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)	`HTTP GET`Odešle požadavek zadanému `requestUri` a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní výčtové operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	`HTTP GET`Odešle požadavek zadanému `requestUri` a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní výčtové operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	`HTTP GET`Odešle požadavek zadanému `requestUri` a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní výčtové operaci.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)	`HTTP GET`Odešle požadavek zadanému `requestUri` a vrátí hodnotu, která je výsledkem deserializace textu odpovědi jako JSON v asynchronní výčtové 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 těla 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 těla odpovědi jako JSON v asynchronní 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla 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 těla odpovědi jako JSON v asynchronní operaci.
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, 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, 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.
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.
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, 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, 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.
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.
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, 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, 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.
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.

Platí pro

Sdílet prostřednictvím