WebClient.CancelAsync メソッド

定義

保留中の非同期操作をキャンセルします。

public:
 void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()

注釈

操作が保留中の場合、このメソッドは基になる WebRequestに対して を呼び出しますAbort

Note

.NET Core 2.0 以降では、 CancelAsync 応答がフェッチを開始した場合、要求はすぐに取り消されません。 最適なキャンセル動作を実現するには、 の代わりに WebClientクラスをHttpClient使用します。

を呼び出 CancelAsyncしても、アプリケーションは操作に関連付けられている完了イベントを受け取ります。 たとえば、 を呼び出 CancelAsync して操作を取り消 DownloadStringAsync すときに、イベントのイベント ハンドラー DownloadStringCompleted を指定した場合、イベント ハンドラーは操作が終了したことを示す通知を受け取ります。 操作が正常に完了したかどうかを確認するには、Cancelledイベント ハンドラーに渡されるイベント データ オブジェクトの の基本クラスDownloadDataCompletedEventArgsの プロパティをチェックします。

非同期操作が進行中でない場合、このメソッドは何も実行しません。

適用対象