HttpClient.SendRequestAsync 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.
Überlädt
| SendRequestAsync(HttpRequestMessage) |
Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im Konzeptthema HttpClient . |
| SendRequestAsync(HttpRequestMessage, HttpCompletionOption) |
Senden Sie eine HTTP-Anforderung mit einer HTTP-Vervollständigungsoption als asynchronen Vorgang. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im Konzeptthema HttpClient . |
SendRequestAsync(HttpRequestMessage)
Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im Konzeptthema HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request) = SendRequestAsync;/// [Windows.Foundation.Metadata.Overload("SendRequestAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);[Windows.Foundation.Metadata.Overload("SendRequestAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);function sendRequestAsync(request)Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Parameter
- request
- HttpRequestMessage
Die zu sendende HTTP-Anforderungsmeldung.
Gibt zurück
Das Objekt, das den asynchronen Vorgang darstellt.
- Attribute
Hinweise
Dieser Vorgang wird nicht blockiert. Der zurückgegebene IAsyncOperationWithProgress (von HttpResponseMessage und HttpProgress) wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.
Die im Anforderungsparameter übergebene HttpRequestMessage ermöglicht es der SendRequestAsync-Methode, Header sowohl für die Anforderungsnachricht als auch für den zu sendenden HTTP-Inhalt festzulegen. Im Gegensatz dazu ermöglichen die Methoden PostAsync und PutAsync nur das Festlegen einer begrenzteren Gruppe von HTTP-Inhaltsheadern.
Im Folgenden finden Sie die Ausnahmen, die diese Funktion auslöst.
E_ILLEGAL_METHOD_CALL
Die Anforderungsnachricht wurde bereits vom HttpClient-instance gesendet.
Ausnahmebehandlung
Sie müssen Code schreiben, um Ausnahmen zu behandeln, wenn Sie diese Methode aufrufen. Ausnahmen können sich auf Fehler bei der Parameterüberprüfung, Fehler bei der Namensauflösung und Netzwerkfehlern ergeben. Ausnahmen von Netzwerkfehlern (z. B. Verbindungsverlust, Verbindungsfehler und HTTP-Serverfehler) können jederzeit auftreten. Diese Fehler haben zur Folge, dass Ausnahmen ausgelöst werden. Wenn sie nicht von Ihrer App verarbeitet wird, kann eine Ausnahme dazu führen, dass Ihre gesamte App von der Runtime beendet wird. Weitere Informationen zum Behandeln von Ausnahmen finden Sie unter Behandeln von Ausnahmen in Netzwerk-Apps und Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen.
Weitere Informationen
- HttpRequestMessage
- PostAsync(Uri, IHttpContent)
- PutAsync(Uri, IHttpContent)
- SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
- HttpClient
Gilt für:
SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
Senden Sie eine HTTP-Anforderung mit einer HTTP-Vervollständigungsoption als asynchronen Vorgang. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im Konzeptthema HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request, HttpCompletionOption completionOption) = SendRequestAsync;/// [Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request, HttpCompletionOption const& completionOption);[Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request, HttpCompletionOption completionOption);function sendRequestAsync(request, completionOption)Public Function SendRequestAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Parameter
- request
- HttpRequestMessage
Die zu sendende HTTP-Anforderungsmeldung.
- completionOption
- HttpCompletionOption
Ein Wert, der angibt, ob der HttpClient-Vorgang als abgeschlossen gilt, wenn die gesamte Antwort gelesen wird oder wenn nur die Header gelesen werden.
Gibt zurück
Das Objekt, das den asynchronen Vorgang darstellt.
- Attribute
Hinweise
Dieser Vorgang wird nicht blockiert. Der zurückgegebene IAsyncOperationWithProgress (von HttpResponseMessage und HttpProgress) wird abhängig vom Wert des completionOption-Parameters abgeschlossen.
Die im Anforderungsparameter übergebene HttpRequestMessage ermöglicht es der SendRequestAsync-Methode, Header sowohl für die Anforderungsnachricht als auch für den zu sendenden HTTP-Inhalt festzulegen. Im Gegensatz dazu ermöglichen die Methoden PostAsync und PutAsync nur das Festlegen einer begrenzteren Gruppe von HTTP-Inhaltsheadern.
Im Folgenden finden Sie die Ausnahmen, die diese Funktion auslöst.
E_ILLEGAL_METHOD_CALL
Die Anforderungsnachricht wurde bereits vom HttpClient-instance gesendet.
Ausnahmebehandlung
Sie müssen Code schreiben, um Ausnahmen zu behandeln, wenn Sie diese Methode aufrufen. Ausnahmen können sich auf Fehler bei der Parameterüberprüfung, Fehler bei der Namensauflösung und Netzwerkfehlern ergeben. Ausnahmen von Netzwerkfehlern (z. B. Verbindungsverlust, Verbindungsfehler und HTTP-Serverfehler) können jederzeit auftreten. Diese Fehler haben zur Folge, dass Ausnahmen ausgelöst werden. Wenn sie nicht von Ihrer App verarbeitet wird, kann eine Ausnahme dazu führen, dass Ihre gesamte App von der Runtime beendet wird. Weitere Informationen zum Behandeln von Ausnahmen finden Sie unter Behandeln von Ausnahmen in Netzwerk-Apps und Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen.