HttpClient Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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) |