HttpClient Klass

Definition

Namnområde:: System.Net.Http

Sammansättning:: System.Net.Http.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Tillhandahåller en klass för att skicka HTTP-begäranden och ta emot HTTP-svar från en resurs som identifieras av en 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

Arv: Object

HttpMessageInvoker
HttpClient

Exempel

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

Kommentarer

Mer information om det här API:et finns i Kompletterande API-kommentarer för HttpClient.

Konstruktorer

Name	Description
HttpClient()	Initierar en ny instans av klassen med en HttpClientHandler som tas bort när den här instansen HttpClient tas bort.
HttpClient(HttpMessageHandler, Boolean)	Initierar en ny instans av klassen med den angivna hanteraren och anger om den hanteraren ska tas bort när den här instansen HttpClient tas bort.
HttpClient(HttpMessageHandler)	Initierar en ny instans av HttpClient klassen med den angivna hanteraren. Hanteraren tas bort när den här instansen tas bort.

Egenskaper

Name	Description
BaseAddress	Hämtar eller anger basadressen för URI (Uniform Resource Identifier) för den Internetresurs som används när begäranden skickas.
DefaultRequestHeaders	Hämtar rubrikerna som ska skickas med varje begäran.
MaxResponseContentBufferSize	Hämtar eller anger det maximala antalet byte som ska buffrad när du läser svarsinnehållet.
Timeout	Hämtar eller anger tidsintervallet för att vänta innan tidsgränsen för begäran överskrids.

Metoder

Name	Description
CancelPendingRequests()	Avbryt alla väntande begäranden på den här instansen.
DeleteAsync(String, CancellationToken)	Skicka en DELETE-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.
DeleteAsync(String)	Skicka en DELETE-begäran till den angivna URI:n som en asynkron åtgärd.
DeleteAsync(Uri, CancellationToken)	Skicka en DELETE-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.
DeleteAsync(Uri)	Skicka en DELETE-begäran till den angivna URI:n som en asynkron åtgärd.
Dispose()	Släpper ohanterade resurser och gör sig av med de hanterade resurser som används av HttpMessageInvoker. (Ärvd från HttpMessageInvoker)
Dispose(Boolean)	Släpper de ohanterade resurser som används av HttpClient och om du vill ta bort de hanterade resurserna.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetAsync(String, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.
GetAsync(String, HttpCompletionOption, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ och en annulleringstoken som en asynkron åtgärd.
GetAsync(String, HttpCompletionOption)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ som en asynkron åtgärd.
GetAsync(String)	Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.
GetAsync(Uri, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ och en annulleringstoken som en asynkron åtgärd.
GetAsync(Uri, HttpCompletionOption)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ som en asynkron åtgärd.
GetAsync(Uri)	Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.
GetByteArrayAsync(String)	Skickar en GET-begäran till den angivna URI:n och returnerar svarstexten som en bytematris i en asynkron åtgärd.
GetByteArrayAsync(Uri)	Skicka en GET-begäran till den angivna URI:n och returnera svarstexten som en bytematris i en asynkron åtgärd.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetStreamAsync(String)	Skicka en GET-begäran till den angivna URI:n och returnera svarstexten som en ström i en asynkron åtgärd.
GetStreamAsync(Uri)	Skicka en GET-begäran till den angivna URI:n och returnera svarstexten som en ström i en asynkron åtgärd.
GetStringAsync(String)	Skicka en GET-begäran till den angivna URI:n och returnera svarstexten som en sträng i en asynkron åtgärd.
GetStringAsync(Uri)	Skicka en GET-begäran till den angivna URI:n och returnera svarstexten som en sträng i en asynkron åtgärd.
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
PatchAsync(String, HttpContent, CancellationToken)	Skickar en PATCH-begäran med en annulleringstoken till en URI som representeras som en sträng som en asynkron åtgärd.
PatchAsync(String, HttpContent)	Skickar en PATCH-begäran till en URI som har angetts som en sträng som en asynkron åtgärd.
PatchAsync(Uri, HttpContent, CancellationToken)	Skickar en PATCH-begäran med en annulleringstoken som en asynkron åtgärd.
PatchAsync(Uri, HttpContent)	Skickar en PATCH-begäran som en asynkron åtgärd.
PostAsync(String, HttpContent, CancellationToken)	Skicka en POST-begäran med en annulleringstoken som en asynkron åtgärd.
PostAsync(String, HttpContent)	Skicka en POST-begäran till den angivna URI:n som en asynkron åtgärd.
PostAsync(Uri, HttpContent, CancellationToken)	Skicka en POST-begäran med en annulleringstoken som en asynkron åtgärd.
PostAsync(Uri, HttpContent)	Skicka en POST-begäran till den angivna URI:n som en asynkron åtgärd.
PutAsync(String, HttpContent, CancellationToken)	Skicka en PUT-begäran med en annulleringstoken som en asynkron åtgärd.
PutAsync(String, HttpContent)	Skicka en PUT-begäran till den angivna URI:n som en asynkron åtgärd.
PutAsync(Uri, HttpContent, CancellationToken)	Skicka en PUT-begäran med en annulleringstoken som en asynkron åtgärd.
PutAsync(Uri, HttpContent)	Skicka en PUT-begäran till den angivna URI:n som en asynkron åtgärd.
SendAsync(HttpRequestMessage, CancellationToken)	Skicka en HTTP-begäran som en asynkron åtgärd.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Skicka en HTTP-begäran som en asynkron åtgärd.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Skicka en HTTP-begäran som en asynkron åtgärd.
SendAsync(HttpRequestMessage)	Skicka en HTTP-begäran som en asynkron åtgärd.
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?