Freigeben über


HttpClient.SendAsync Methode

Definition

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

Überlädt

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

SendAsync(HttpRequestMessage)

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

SendAsync(HttpRequestMessage, HttpCompletionOption)

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

SendAsync(HttpRequestMessage, CancellationToken)

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

Hinweise

Dieser Vorgang wird nicht blockiert.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsmeldung.

completionOption
HttpCompletionOption

Wann der Vorgang abgeschlossen werden sollte (sobald eine Antwort verfügbar ist, oder nach dem Lesen des gesamten Inhalts der Antwort).

cancellationToken
CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

request ist null.

Die Anforderungsnachricht wurde bereits von der HttpClient-Instanz gesendet.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Abhängig vom Wert des completionOption Parameters wird das zurückgegebene Task<TResult> Objekt abgeschlossen, sobald eine Antwort verfügbar ist oder die gesamte Antwort einschließlich Inhalt gelesen wird.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Send(HttpRequestMessage, HttpCompletionOption)Ausnahmen.

Gilt für:

SendAsync(HttpRequestMessage)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request);
override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsmeldung.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

request ist null.

Die Anforderungsnachricht wurde bereits von der HttpClient-Instanz gesendet.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, sobald die gesamte Antwort einschließlich des Inhalts gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Send(HttpRequestMessage)Ausnahmen.

Gilt für:

SendAsync(HttpRequestMessage, HttpCompletionOption)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);
override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsmeldung.

completionOption
HttpCompletionOption

Wann der Vorgang abgeschlossen werden sollte (sobald eine Antwort verfügbar ist, oder nach dem Lesen des gesamten Inhalts der Antwort).

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

request ist null.

Die Anforderungsnachricht wurde bereits von der HttpClient-Instanz gesendet.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Hinweise

Dieser Vorgang wird nicht blockiert. Abhängig vom Wert des completionOption Parameters wird das zurückgegebene Task<TResult> Objekt abgeschlossen, sobald eine Antwort verfügbar ist oder die gesamte Antwort einschließlich Inhalt gelesen wird.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Send(HttpRequestMessage, HttpCompletionOption)Ausnahmen.

Gilt für:

SendAsync(HttpRequestMessage, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine HTTP-Anforderung als asynchronen Vorgang.

public:
 override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);
override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsmeldung.

cancellationToken
CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

request ist null.

Die Anforderungsnachricht wurde bereits von der HttpClient-Instanz gesendet.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, sobald die gesamte Antwort einschließlich des Inhalts gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Send(HttpRequestMessage)Ausnahmen.

Gilt für: