HttpClient.DeleteAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期操作として、指定した URI に DELETE 要求を送信します。
オーバーロード
| 名前 | 説明 |
|---|---|
| DeleteAsync(String) |
非同期操作として、指定した URI に DELETE 要求を送信します。 |
| DeleteAsync(Uri) |
非同期操作として、指定した URI に DELETE 要求を送信します。 |
| DeleteAsync(String, CancellationToken) |
非同期操作としてキャンセル トークンを使用して、DELETE 要求を指定された URI に送信します。 |
| DeleteAsync(Uri, CancellationToken) |
非同期操作としてキャンセル トークンを使用して、DELETE 要求を指定された URI に送信します。 |
DeleteAsync(String)
非同期操作として、指定した 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。
返品
非同期操作を表すタスク オブジェクト。
例外
要求メッセージは、 HttpClient インスタンスによって既に送信されています。
-または-
requestUriは絶対 URI ではありません。
-または-
BaseAddress が設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError によって示されます。
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
適用対象
DeleteAsync(Uri)
非同期操作として、指定した 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。
返品
非同期操作を表すタスク オブジェクト。
例外
要求メッセージは、 HttpClient インスタンスによって既に送信されています。
-または-
requestUriは絶対 URI ではありません。
-または-
BaseAddress が設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
適用対象
DeleteAsync(String, CancellationToken)
非同期操作としてキャンセル トークンを使用して、DELETE 要求を指定された 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
他のオブジェクトまたはスレッドが取り消し通知を受け取るために使用できるキャンセル トークン。
返品
非同期操作を表すタスク オブジェクト。
例外
要求メッセージは、 HttpClient インスタンスによって既に送信されています。
-または-
requestUriは絶対 URI ではありません。
-または-
BaseAddress が設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
適用対象
DeleteAsync(Uri, CancellationToken)
非同期操作としてキャンセル トークンを使用して、DELETE 要求を指定された 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
他のオブジェクトまたはスレッドが取り消し通知を受け取るために使用できるキャンセル トークン。
返品
非同期操作を表すタスク オブジェクト。
例外
要求メッセージは、 HttpClient インスタンスによって既に送信されています。
-または-
requestUriは絶対 URI ではありません。
-または-
BaseAddress が設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。