HttpClient Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Klasse zum Senden von HTTP-Anforderungen und zum Empfangen von HTTP-Antworten von einer Ressource bereit, die durch einen URI identifiziert wurde.
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
- Vererbung
Beispiele
// 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
Hinweise
Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für HttpClient.
Konstruktoren
HttpClient() |
Initialisiert eine neue Instanz der HttpClient-Klasse mithilfe eines HttpClientHandler-Objekts, das bei Freigabe dieser Instanz freigegeben wird. |
HttpClient(HttpMessageHandler) |
Initialisiert eine neue Instanz der HttpClient-Klasse mit dem angegebenen Handler. Der Handler wird freigegeben, wenn diese Instanz freigegeben wird. |
HttpClient(HttpMessageHandler, Boolean) |
Initialisiert eine neue Instanz der HttpClient-Klasse mit dem bereitgestellten Handler und gibt an, ob dieser Handler freigegeben werden soll, wenn diese Instanz freigegeben wird. |
Eigenschaften
BaseAddress |
Ruft die Basisadresse des URI (Uniform Resource Identifier) der Internetressource ab, die verwendet wird, wenn Anforderungen gesendet werden, oder legt diese fest. |
DefaultProxy |
Ruft den globalen HTTP-Proxy ab oder legt diesen fest. |
DefaultRequestHeaders |
Ruft die Header ab, die mit jeder Anforderung gesendet werden sollen. |
DefaultRequestVersion |
Ruft die HTTP-Standardversion ab, die für nachfolgende Anforderungen dieser HttpClient-Klasse verwendet wird, oder legt diese fest. |
DefaultVersionPolicy |
Ruft die Standardversionsrichtlinie für implizit erstellte Anforderungen in Hilfsmethoden (z. B. GetAsync(String) und PostAsync(String, HttpContent)) ab oder legt sie fest. |
MaxResponseContentBufferSize |
Ruft beim Lesen des Antwortinhalts die maximale Anzahl zwischenzuspeichernder Bytes ab oder legt diese fest. |
Timeout |
Ruft die Zeitspanne ab, nach der das Zeitlimit der Anforderung überschritten ist, oder legt diese fest. |
Methoden
CancelPendingRequests() |
Alle ausstehenden Anforderungen für diese Instanz abbrechen. |
DeleteAsync(String) |
Eine DELETE-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
DeleteAsync(String, CancellationToken) |
Eine DELETE-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden. |
DeleteAsync(Uri) |
Eine DELETE-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
DeleteAsync(Uri, CancellationToken) |
Eine DELETE-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden. |
Dispose() |
Gibt die vom HttpMessageInvoker verwendeten, nicht verwalteten Ressourcen frei und verwirft die verwalteten Ressourcen. (Geerbt von HttpMessageInvoker) |
Dispose(Boolean) |
Gibt die vom HttpClient verwendeten, nicht verwalteten Ressourcen frei und verwirft optional auch die verwalteten Ressourcen. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetAsync(String) |
Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
GetAsync(String, CancellationToken) |
Eine GET-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden. |
GetAsync(String, HttpCompletionOption) |
Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang senden. |
GetAsync(String, HttpCompletionOption, CancellationToken) |
Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang senden. |
GetAsync(Uri) |
Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
GetAsync(Uri, CancellationToken) |
Eine GET-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden. |
GetAsync(Uri, HttpCompletionOption) |
Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang senden. |
GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang senden. |
GetByteArrayAsync(String) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Antworttext in einem asynchronen Vorgang als Bytearray zurück. |
GetByteArrayAsync(String, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Antworttext in einem asynchronen Vorgang als Bytearray zurück. |
GetByteArrayAsync(Uri) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück. |
GetByteArrayAsync(Uri, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetStreamAsync(String) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück. |
GetStreamAsync(String, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück. |
GetStreamAsync(Uri) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück. |
GetStreamAsync(Uri, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück. |
GetStringAsync(String) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück. |
GetStringAsync(String, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück. |
GetStringAsync(Uri) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück. |
GetStringAsync(Uri, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück. |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
PatchAsync(String, HttpContent) |
Sendet eine PATCH-Anforderung an einen Uri, der als eine Zeichenfolge als asynchroner Vorgang festgelegt ist. |
PatchAsync(String, HttpContent, CancellationToken) |
Sendet eine PATCH-Anforderung mit einem Abbruchtoken an einen URI, dargestellt als Zeichenfolge als asynchroner Vorgang. |
PatchAsync(Uri, HttpContent) |
Sendet eine PATCH-Anforderung als asynchronen Vorgang. |
PatchAsync(Uri, HttpContent, CancellationToken) |
Sendet eine PATCH-Anforderung mit einem Abbruchtoken als einen asynchronen Vorgang. |
PostAsync(String, HttpContent) |
Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
PostAsync(String, HttpContent, CancellationToken) |
Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden. |
PostAsync(Uri, HttpContent) |
Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
PostAsync(Uri, HttpContent, CancellationToken) |
Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden. |
PutAsync(String, HttpContent) |
Eine PUT-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
PutAsync(String, HttpContent, CancellationToken) |
Eine PUT-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden. |
PutAsync(Uri, HttpContent) |
Eine PUT-Anforderung an den angegebenen URI als asynchronen Vorgang senden. |
PutAsync(Uri, HttpContent, CancellationToken) |
Eine PUT-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden. |
Send(HttpRequestMessage) |
Sendet eine HTTP-Anforderung mit der angegebenen Anforderung. |
Send(HttpRequestMessage, CancellationToken) |
Sendet eine HTTP-Anforderung mit der angegebenen Anforderung und einem Abbruchtoken. |
Send(HttpRequestMessage, CancellationToken) |
Sendet eine HTTP-Anforderung mit der angegebenen Anforderung und einem Abbruchtoken. (Geerbt von HttpMessageInvoker) |
Send(HttpRequestMessage, HttpCompletionOption) |
Sendet eine HTTP-Anforderung. |
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Sendet eine HTTP-Anforderung mit der angegebenen Anforderung, der Abschlussoption und einem Abbruchtoken. |
SendAsync(HttpRequestMessage) |
Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. |
SendAsync(HttpRequestMessage, CancellationToken) |
Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. |
SendAsync(HttpRequestMessage, HttpCompletionOption) |
Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. |
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Erweiterungsmethoden
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken) |
Sendet eine DELETE-Anforderung an den angegebenen Uri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Sendet eine |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken) |
Sendet eine |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Sendet eine |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken) |
Sendet eine |
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync(HttpClient, String, Type, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Wert zurück, der sich beim Deserialisieren des Antworttexts als JSON in einem asynchronen Vorgang ergibt. |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Sendet eine PATCH-Anforderung an den angegebenen Uri, der das |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine PATCH-Anforderung an den angegebenen Uri, der das |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Sendet eine PATCH-Anforderung an den angegebenen Uri, der das |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Sendet eine PATCH-Anforderung an den angegebenen Uri, der das |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Sendet eine PATCH-Anforderung an den angegebenen Uri, der das |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Sendet eine PATCH-Anforderung an den angegebenen Uri, der das |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Senden einer PUT-Anforderung an den angegebenen URI, der den |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Senden einer PUT-Anforderung an den angegebenen URI, der den |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Senden einer PUT-Anforderung an den angegebenen URI, der den |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Senden einer PUT-Anforderung an den angegebenen URI, der den |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Senden einer PUT-Anforderung an den angegebenen URI, der den |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Senden einer PUT-Anforderung an den angegebenen URI, der den |