HttpClient.PostAsync メソッド

定義

指定された URI に POST 要求を非同期操作として送信します。

オーバーロード

PostAsync(String, HttpContent, CancellationToken)

POST 要求をキャンセル トークンとともに非同期操作として送信します。

PostAsync(Uri, HttpContent, CancellationToken)

POST 要求をキャンセル トークンとともに非同期操作として送信します。

PostAsync(String, HttpContent)

指定された URI に POST 要求を非同期操作として送信します。

PostAsync(Uri, HttpContent)

指定された URI に POST 要求を非同期操作として送信します。

注釈

この操作はブロックされません。

PostAsync(String, HttpContent, CancellationToken)

POST 要求をキャンセル トークンとともに非同期操作として送信します。

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)

パラメーター

requestUri
String

要求の送信先 URI。

content
HttpContent

サーバーに送信される HTTP 要求の内容。

cancellationToken
CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

非同期操作を表すタスク オブジェクト。

例外

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。

注意

タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。

適用対象

PostAsync(Uri, HttpContent, CancellationToken)

POST 要求をキャンセル トークンとともに非同期操作として送信します。

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)

パラメーター

requestUri
Uri

要求の送信先 URI。

content
HttpContent

サーバーに送信される HTTP 要求の内容。

cancellationToken
CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

非同期操作を表すタスク オブジェクト。

例外

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。

注意

タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。

適用対象

PostAsync(String, HttpContent)

指定された URI に POST 要求を非同期操作として送信します。

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)

パラメーター

requestUri
String

要求の送信先 URI。

content
HttpContent

サーバーに送信される HTTP 要求の内容。

戻り値

非同期操作を表すタスク オブジェクト。

例外

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。

Note

タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。

適用対象

PostAsync(Uri, HttpContent)

指定された URI に POST 要求を非同期操作として送信します。

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)

パラメーター

requestUri
Uri

要求の送信先 URI。

content
HttpContent

サーバーに送信される HTTP 要求の内容。

戻り値

非同期操作を表すタスク オブジェクト。

例外

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。

注意

タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。

適用対象