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
| Name | Beschreibung |
|---|---|
| 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 blockiert nicht.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
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-Anforderungsnachricht.
- completionOption
- HttpCompletionOption
Wenn der Vorgang abgeschlossen werden soll (sobald eine Antwort verfügbar ist oder nachdem der gesamte Antwortinhalt gelesen wurde).
- cancellationToken
- CancellationToken
Das Abbruchtoken zum Abbrechen des Vorgangs.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
request ist null.
Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
-oder-
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Je nach Wert des completionOption Parameters wird das zurückgegebene Task<TResult> Objekt abgeschlossen, sobald eine Antwort verfügbar ist oder die gesamte Antwort einschließlich des Inhalts gelesen wird.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Send(HttpRequestMessage, HttpCompletionOption).
Gilt für:
SendAsync(HttpRequestMessage)
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-Anforderungsnachricht.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
request ist null.
Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, sobald die gesamte Antwort einschließlich Inhalt gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Send(HttpRequestMessage).
Gilt für:
SendAsync(HttpRequestMessage, HttpCompletionOption)
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-Anforderungsnachricht.
- completionOption
- HttpCompletionOption
Wenn der Vorgang abgeschlossen werden soll (sobald eine Antwort verfügbar ist oder nachdem der gesamte Antwortinhalt gelesen wurde).
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
request ist null.
Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Je nach Wert des completionOption Parameters wird das zurückgegebene Task<TResult> Objekt abgeschlossen, sobald eine Antwort verfügbar ist oder die gesamte Antwort einschließlich des Inhalts gelesen wird.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Send(HttpRequestMessage, HttpCompletionOption).
Gilt für:
SendAsync(HttpRequestMessage, CancellationToken)
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-Anforderungsnachricht.
- cancellationToken
- CancellationToken
Das Abbruchtoken zum Abbrechen des Vorgangs.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
request ist null.
Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
-oder-
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, sobald die gesamte Antwort einschließlich Inhalt gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Send(HttpRequestMessage).