HttpClient.PostAsync(Uri, IHttpContent) 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 POST-Anforderung als asynchronen Vorgang an den angegebenen URI. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ PostAsync(Uri ^ uri, IHttpContent ^ content) = PostAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> PostAsync(Uri const& uri, IHttpContent const& content);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> PostAsync(System.Uri uri, IHttpContent content);
function postAsync(uri, content)
Public Function PostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)
Parameter
- content
- IHttpContent
Der HTTP-Anforderungsinhalt, der an den Server gesendet werden soll.
Gibt zurück
Das -Objekt, das den asynchronen Vorgang darstellt.
- Attribute
Beispiele
Beispiele für den Aufruf von HttpClient.PostAsync finden Sie unter HttpClient.
Hinweise
Dieser Vorgang wird nicht blockiert. Die zurückgegebene IAsyncOperationWithProgress (vonHttpResponseMessage und HttpProgress) wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde.
Mit den Methoden PostAsync und PutAsync können nur eine begrenzte Anzahl von HTTP-Inhaltsheadern festgelegt werden. Im Gegensatz dazu ermöglicht die SendRequestAsync-Methode das Festlegen von Headern für die Anforderungsnachricht sowie für den zu sendenden HTTP-Inhalt.
Im Folgenden finden Sie die Ausnahmen, die von dieser Funktion ausgelöst werden.
E_INVALIDARG
Der URI-Parameter war ein NULL-Verweis (Nothing in Visual Basic).
Ausnahmebehandlung
Sie müssen Code schreiben, um Ausnahmen zu behandeln, wenn Sie diese Methode aufrufen. Ausnahmen können sich aus Parametervalidierungsfehlern, Namensauflösungsfehlern 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 behandelt 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.