WebClient.CancelAsync メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

ソース:

WebClient.cs

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

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

注釈

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

注意

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

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

非同期操作が進行中でなければ、このメソッドは何も行いません。