HttpClient.PutAsync メソッド

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

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

オーバーロード

PutAsync(String, HttpContent)	非同期操作として、指定した URI に PUT 要求を送信します。
PutAsync(Uri, HttpContent)	非同期操作として、指定した URI に PUT 要求を送信します。
PutAsync(String, HttpContent, CancellationToken)	キャンセル トークンを使用して PUT 要求を非同期操作として送信します。
PutAsync(Uri, HttpContent, CancellationToken)	キャンセル トークンを使用して PUT 要求を非同期操作として送信します。

注釈

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

PutAsync(String, HttpContent)

ソース:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent? content);

member this.PutAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先の URI。

content

HttpContent

サーバーに送信される HTTP 要求コンテンツ。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri は絶対 URI であるか、BaseAddress を設定する必要があります。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証、タイムアウトなどの根本的な問題が原因で要求が失敗しました。

TaskCanceledException

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

UriFormatException

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

注釈

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

手記

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

• HttpRequestException は、該当するすべての .NET Framework バージョンでスローされます。
• 内部例外のない TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TimeoutException を入れ子にする TaskCanceledException は、.NET 5 以降のバージョンでスローされます。

PutAsync(Uri, HttpContent)

ソース:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent? content);

member this.PutAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先の URI。

content

HttpContent

サーバーに送信される HTTP 要求コンテンツ。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri は絶対 URI であるか、BaseAddress を設定する必要があります。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証、タイムアウトなどの根本的な問題が原因で要求が失敗しました。

TaskCanceledException

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

注釈

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

手記

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

• HttpRequestException は、該当するすべての .NET Framework バージョンでスローされます。
• 内部例外のない TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TimeoutException を入れ子にする TaskCanceledException は、.NET 5 以降のバージョンでスローされます。

PutAsync(String, HttpContent, CancellationToken)

ソース:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PutAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先の URI。

content

HttpContent

サーバーに送信される HTTP 要求コンテンツ。

cancellationToken

CancellationToken

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

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri は絶対 URI であるか、BaseAddress を設定する必要があります。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証、タイムアウトなどの根本的な問題が原因で要求が失敗しました。

TaskCanceledException

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

UriFormatException

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

OperationCanceledException

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

注釈

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

手記

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

• HttpRequestException は、該当するすべての .NET Framework バージョンでスローされます。
• 内部例外のない TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TimeoutException を入れ子にする TaskCanceledException は、.NET 5 以降のバージョンでスローされます。

PutAsync(Uri, HttpContent, CancellationToken)

ソース:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PutAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先の URI。

content

HttpContent

サーバーに送信される HTTP 要求コンテンツ。

cancellationToken

CancellationToken

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

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri は絶対 URI であるか、BaseAddress を設定する必要があります。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証、タイムアウトなどの根本的な問題が原因で要求が失敗しました。

TaskCanceledException

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

OperationCanceledException

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

注釈

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

手記

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

• HttpRequestException は、該当するすべての .NET Framework バージョンでスローされます。
• 内部例外のない TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TimeoutException を入れ子にする TaskCanceledException は、.NET 5 以降のバージョンでスローされます。