HttpClient.SendAsync Methode
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.
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.
- HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
- TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen 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.
- HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
- TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen 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.
- HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
- TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen 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.
- HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
- TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen 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.
