HttpClient.PostAsync Methode

Definition

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

Überlädt

PostAsync(String, HttpContent, CancellationToken)

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.

PostAsync(Uri, HttpContent, CancellationToken)

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.

PostAsync(String, HttpContent)

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

PostAsync(Uri, HttpContent)

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

Hinweise

Dieser Vorgang wird nicht blockiert.

PostAsync(String, HttpContent, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.

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);
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.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.

cancellationToken
CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Der angegebene Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde.

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Gilt für:

PostAsync(Uri, HttpContent, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Eine POST-Anforderung mit einem Abbruchtoken als asynchronen Vorgang senden.

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);
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.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.

cancellationToken
CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde.

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Gilt für:

PostAsync(String, HttpContent)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

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);
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.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Der angegebene Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde.

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Gilt für:

PostAsync(Uri, HttpContent)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Eine POST-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

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);
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.

content
HttpContent

Der Inhalt der HTTP-Anforderung, die an den Server gesendet wird.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde.

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

Gilt für: