HttpClient.PostAsync Methode

Definition

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.Send a POST request to the specified Uri as an asynchronous operation.

Überlädt

PostAsync(String, HttpContent, CancellationToken)

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.Send a POST request with a cancellation token as an asynchronous operation.

PostAsync(Uri, HttpContent, CancellationToken)

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.Send a POST request with a cancellation token as an asynchronous operation.

PostAsync(String, HttpContent)

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.Send a POST request to the specified Uri as an asynchronous operation.

PostAsync(Uri, HttpContent)

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.Send a POST request to the specified Uri as an asynchronous operation.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block.

PostAsync(String, HttpContent, CancellationToken)

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.Send a POST request with a cancellation token as an asynchronous operation.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

requestUri
String

Der URI, an den die Anforderung gesendet wird.The Uri the request is sent to.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.The HTTP request content sent to the server.

cancellationToken
CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.The requestUri must be an absolute URI or BaseAddress must be set.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

Nur .NET Core und .NET 5.0: Die Anforderung konnte aufgrund eines Timeouts nicht ausgeführt werden..NET Core and .NET 5.0 and later only: The request failed due to timeout.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird beendet, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.The returned Task<TResult> object will complete after the whole response (including content) is read.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .net-Implementierungen ausgelöst.In case of timeout, different exceptions are thrown on different .NET implementations.

Gilt für:

PostAsync(Uri, HttpContent, CancellationToken)

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.Send a POST request with a cancellation token as an asynchronous operation.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

requestUri
Uri

Der URI, an den die Anforderung gesendet wird.The Uri the request is sent to.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.The HTTP request content sent to the server.

cancellationToken
CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.The requestUri must be an absolute URI or BaseAddress must be set.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

Nur .NET Core und .NET 5.0: Die Anforderung konnte aufgrund eines Timeouts nicht ausgeführt werden..NET Core and .NET 5.0 and later only: The request failed due to timeout.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird beendet, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.The returned Task<TResult> object will complete after the whole response (including content) is read.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .net-Implementierungen ausgelöst.In case of timeout, different exceptions are thrown on different .NET implementations.

Gilt für:

PostAsync(String, HttpContent)

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.Send a POST request to the specified Uri as an asynchronous operation.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content);
member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

Parameter

requestUri
String

Der URI, an den die Anforderung gesendet wird.The Uri the request is sent to.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.The HTTP request content sent to the server.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.The requestUri must be an absolute URI or BaseAddress must be set.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

Nur .NET Core und .NET 5.0: Die Anforderung konnte aufgrund eines Timeouts nicht ausgeführt werden..NET Core and .NET 5.0 and later only: The request failed due to timeout.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird beendet, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.The returned Task<TResult> object will complete after the whole response (including content) is read.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .net-Implementierungen ausgelöst.In case of timeout, different exceptions are thrown on different .NET implementations.

Gilt für:

PostAsync(Uri, HttpContent)

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.Send a POST request to the specified Uri as an asynchronous operation.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content);
member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

Parameter

requestUri
Uri

Der URI, an den die Anforderung gesendet wird.The Uri the request is sent to.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.The HTTP request content sent to the server.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.The requestUri must be an absolute URI or BaseAddress must be set.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

Nur .NET Core und .NET 5.0: Die Anforderung konnte aufgrund eines Timeouts nicht ausgeführt werden..NET Core and .NET 5.0 and later only: The request failed due to timeout.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird beendet, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.The returned Task<TResult> object will complete after the whole response (including content) is read.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .net-Implementierungen ausgelöst.In case of timeout, different exceptions are thrown on different .NET implementations.

Gilt für: