Auf Englisch lesen

Freigeben über


HttpClient Klasse

Definition

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 class HttpClient : System.Net.Http.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);
    }
}

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 HTTP GET Anforderung an den angegebenen requestUri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen aufzählbaren Vorgang ergibt.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)

Sendet eine HTTP GETAnforderung an den angegebenen requestUri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen aufzählbaren Vorgang ergibt.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)

Sendet eine HTTP GETAnforderung an den angegebenen requestUri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen aufzählbaren Vorgang ergibt.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)

Sendet eine HTTP GETAnforderung an den angegebenen requestUri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen aufzählbaren Vorgang ergibt.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)

Sendet eine HTTP GETAnforderung an den angegebenen requestUri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen aufzählbaren Vorgang ergibt.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)

Sendet eine HTTP GETAnforderung an den angegebenen requestUri und gibt den Wert zurück, der sich aus der Deserialisierung des Antworttexts als JSON in einem asynchronen aufzählbaren Vorgang ergibt.

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 value als JSON im Anforderungstext serialisierte enthält.

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

Sendet eine PATCH-Anforderung an den angegebenen Uri, der das value als JSON im Anforderungstext serialisierte enthält.

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

Sendet eine PATCH-Anforderung an den angegebenen Uri, der das value als JSON im Anforderungstext serialisierte enthält.

PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

Sendet eine PATCH-Anforderung an den angegebenen Uri, der das value als JSON im Anforderungstext serialisierte enthält.

PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

Sendet eine PATCH-Anforderung an den angegebenen Uri, der das value als JSON im Anforderungstext serialisierte enthält.

PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

Sendet eine PATCH-Anforderung an den angegebenen Uri, der das value als JSON im Anforderungstext serialisierte enthält.

PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten value im Anforderungstext enthält.

PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten value im Anforderungstext enthält.

PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten value im Anforderungstext enthält.

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten value im Anforderungstext enthält.

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten value im Anforderungstext enthält.

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

Sendet einer POST-Anforderung an den angegebenen URI, der den als JSON serialisierten value im Anforderungstext enthält.

PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

Senden einer PUT-Anforderung an den angegebenen URI, der den value serialisiert als JSON-Code im Anforderungstext enthält.

PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

Senden einer PUT-Anforderung an den angegebenen URI, der den value serialisiert als JSON-Code im Anforderungstext enthält.

PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

Senden einer PUT-Anforderung an den angegebenen URI, der den value serialisiert als JSON-Code im Anforderungstext enthält.

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

Senden einer PUT-Anforderung an den angegebenen URI, der den value serialisiert als JSON-Code im Anforderungstext enthält.

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

Senden einer PUT-Anforderung an den angegebenen URI, der den value serialisiert als JSON-Code im Anforderungstext enthält.

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

Senden einer PUT-Anforderung an den angegebenen URI, der den value serialisiert als JSON-Code im Anforderungstext enthält.

Gilt für:

Weitere Informationen