HttpClient Klas

Definitie

Biedt een klasse voor het verzenden van HTTP-aanvragen en het ontvangen van HTTP-antwoorden van een resource die is geïdentificeerd door een 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
Overname

Voorbeelden

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

Opmerkingen

Zie Aanvullende API-opmerkingen voor HttpClient voor meer informatie over deze API.

Constructors

Name Description
HttpClient()

Initialiseert een nieuw exemplaar van de HttpClient klasse met behulp van een HttpClientHandler exemplaar dat wordt verwijderd wanneer dit exemplaar wordt verwijderd.

HttpClient(HttpMessageHandler, Boolean)

Initialiseert een nieuw exemplaar van de HttpClient klasse met de opgegeven handler en geeft aan of die handler moet worden verwijderd wanneer dit exemplaar wordt verwijderd.

HttpClient(HttpMessageHandler)

Initialiseert een nieuw exemplaar van de HttpClient klasse met de opgegeven handler. De handler wordt verwijderd wanneer dit exemplaar wordt verwijderd.

Eigenschappen

Name Description
BaseAddress

Hiermee haalt u het basisadres van de URI (Uniform Resource Identifier) van de internetresource op die wordt gebruikt bij het verzenden van aanvragen.

DefaultRequestHeaders

Hiermee haalt u de headers op die bij elke aanvraag moeten worden verzonden.

MaxResponseContentBufferSize

Hiermee haalt u het maximum aantal bytes op dat moet worden gebufferd bij het lezen van de antwoordinhoud.

Timeout

Hiermee wordt de tijdsperiode opgehaald of ingesteld om te wachten voordat er een time-out optreedt voor de aanvraag.

Methoden

Name Description
CancelPendingRequests()

Alle aanvragen die in behandeling zijn op dit exemplaar annuleren.

DeleteAsync(String, CancellationToken)

Verzend een DELETE-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking.

DeleteAsync(String)

Verzend een DELETE-aanvraag naar de opgegeven URI als asynchrone bewerking.

DeleteAsync(Uri, CancellationToken)

Verzend een DELETE-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking.

DeleteAsync(Uri)

Verzend een DELETE-aanvraag naar de opgegeven URI als asynchrone bewerking.

Dispose()

Publiceert de onbeheerde resources en verwijdert de beheerde resources die door de HttpMessageInvoker.

(Overgenomen van HttpMessageInvoker)
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de HttpClient beheerde resources en verwijdert desgewenst de beheerde resources.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetAsync(String, CancellationToken)

Verzend een GET-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking.

GetAsync(String, HttpCompletionOption, CancellationToken)

Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie en een annuleringstoken als asynchrone bewerking.

GetAsync(String, HttpCompletionOption)

Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie als asynchrone bewerking.

GetAsync(String)

Verzend een GET-aanvraag naar de opgegeven URI als asynchrone bewerking.

GetAsync(Uri, CancellationToken)

Verzend een GET-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie en een annuleringstoken als asynchrone bewerking.

GetAsync(Uri, HttpCompletionOption)

Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie als asynchrone bewerking.

GetAsync(Uri)

Verzend een GET-aanvraag naar de opgegeven URI als asynchrone bewerking.

GetByteArrayAsync(String)

Verzendt een GET-aanvraag naar de opgegeven URI en retourneert de antwoordtekst als een bytematrix in een asynchrone bewerking.

GetByteArrayAsync(Uri)

Verzend een GET-aanvraag naar de opgegeven URI en retourneer de antwoordtekst als een bytematrix in een asynchrone bewerking.

GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetStreamAsync(String)

Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking.

GetStreamAsync(Uri)

Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking.

GetStringAsync(String)

Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een tekenreeks in een asynchrone bewerking.

GetStringAsync(Uri)

Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een tekenreeks in een asynchrone bewerking.

GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
PatchAsync(String, HttpContent, CancellationToken)

Verzendt een PATCH-aanvraag met een annuleringstoken naar een URI die wordt weergegeven als een tekenreeks als asynchrone bewerking.

PatchAsync(String, HttpContent)

Verzendt een PATCH-aanvraag naar een URI die is aangewezen als een tekenreeks als asynchrone bewerking.

PatchAsync(Uri, HttpContent, CancellationToken)

Verzendt een PATCH-aanvraag met een annuleringstoken als asynchrone bewerking.

PatchAsync(Uri, HttpContent)

Verzendt een PATCH-aanvraag als asynchrone bewerking.

PostAsync(String, HttpContent, CancellationToken)

Verzend een POST-aanvraag met een annuleringstoken als asynchrone bewerking.

PostAsync(String, HttpContent)

Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking.

PostAsync(Uri, HttpContent, CancellationToken)

Verzend een POST-aanvraag met een annuleringstoken als asynchrone bewerking.

PostAsync(Uri, HttpContent)

Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking.

PutAsync(String, HttpContent, CancellationToken)

Verzend een PUT-aanvraag met een annuleringstoken als asynchrone bewerking.

PutAsync(String, HttpContent)

Verzend een PUT-aanvraag naar de opgegeven URI als asynchrone bewerking.

PutAsync(Uri, HttpContent, CancellationToken)

Verzend een PUT-aanvraag met een annuleringstoken als asynchrone bewerking.

PutAsync(Uri, HttpContent)

Verzend een PUT-aanvraag naar de opgegeven URI als asynchrone bewerking.

SendAsync(HttpRequestMessage, CancellationToken)

Verzend een HTTP-aanvraag als asynchrone bewerking.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Verzend een HTTP-aanvraag als asynchrone bewerking.

SendAsync(HttpRequestMessage, HttpCompletionOption)

Verzend een HTTP-aanvraag als asynchrone bewerking.

SendAsync(HttpRequestMessage)

Verzend een HTTP-aanvraag als asynchrone bewerking.

ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook