HttpClient.DeleteAsync メソッド

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

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

オーバーロード

DeleteAsync(String)	指定された URI に DELETE 要求を非同期操作として送信します。
DeleteAsync(Uri)	指定された URI に DELETE 要求を非同期操作として送信します。
DeleteAsync(String, CancellationToken)	非同期操作としてキャンセル トークンを使用して削除要求を指定された Uri に送信します。
DeleteAsync(Uri, CancellationToken)	非同期操作としてキャンセル トークンを使用して削除要求を指定された Uri に送信します。

DeleteAsync(String)

ソース:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync (string? requestUri);

member this.DeleteAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As String) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先 URI。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

要求メッセージは HttpClient インスタンスによって既に送信されました。

または

requestUri が絶対 URI ではありません。

または

BaseAddress が設定されていません。

HttpRequestException

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

TaskCanceledException

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

注釈

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

注意

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

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

DeleteAsync(Uri)

ソース:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync (Uri? requestUri);

member this.DeleteAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先 URI。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

要求メッセージは HttpClient インスタンスによって既に送信されました。

または

requestUri が絶対 URI ではありません。

または

BaseAddress が設定されていません。

HttpRequestException

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

TaskCanceledException

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

注釈

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

注意

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

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

DeleteAsync(String, CancellationToken)

ソース:

HttpClient.cs

非同期操作としてキャンセル トークンを使用して削除要求を指定された Uri に送信します。

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

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

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

Public Function DeleteAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先 URI。

cancellationToken

CancellationToken

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

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

要求メッセージは HttpClient インスタンスによって既に送信されました。

または

requestUri が絶対 URI ではありません。

または

BaseAddress が設定されていません。

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

注釈

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

注意

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

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

DeleteAsync(Uri, CancellationToken)

ソース:

HttpClient.cs

非同期操作としてキャンセル トークンを使用して削除要求を指定された Uri に送信します。

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

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

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

Public Function DeleteAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先 URI。

cancellationToken

CancellationToken

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

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

要求メッセージは HttpClient インスタンスによって既に送信されました。

または

requestUri が絶対 URI ではありません。

または

BaseAddress が設定されていません。

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

注釈

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

注意

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

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