HttpClient.PostAsync(Uri, IHttpContent) Methode

Definition

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

uri
Uri Uri

Der URI, an den die Anforderung gesendet wird.

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.

Gilt für:

Weitere Informationen