HttpClient Třída

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

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ů.
DefaultRequestHeaders	Získá hlavičky, které mají být odeslány s každou žádostí.
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čí, zda se zadaný objekt rovná 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)	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)	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)	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)
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.
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)

Viz také

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