BackgroundWorker.CancelAsync メソッド

定義

保留中のバックグラウンド操作のキャンセルを要求します。Requests cancellation of a pending background operation.

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

例外

メソッドを使用して CancelAsync 非同期 ("バックグラウンド") 操作をキャンセルする方法を次のコード例に示します。The following code example demonstrates the use of the CancelAsync method to cancel an asynchronous ("background") operation. このコード例は、BackgroundWorker クラスのために提供されている大規模な例の一部です。This code example is part of a larger example provided for the BackgroundWorker class.

void cancelAsyncButton_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{  
   // Cancel the asynchronous operation.
   this->backgroundWorker1->CancelAsync();
   
   // Disable the Cancel button.
   cancelAsyncButton->Enabled = false;
}
private void cancelAsyncButton_Click(System.Object sender, 
    System.EventArgs e)
{   
    // Cancel the asynchronous operation.
    this.backgroundWorker1.CancelAsync();

    // Disable the Cancel button.
    cancelAsyncButton.Enabled = false;
}
Private Sub cancelAsyncButton_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles cancelAsyncButton.Click
    
    ' Cancel the asynchronous operation.
    Me.backgroundWorker1.CancelAsync()

    ' Disable the Cancel button.
    cancelAsyncButton.Enabled = False
    
End Sub

注釈

CancelAsync 保留中のバックグラウンド操作を終了する要求を送信し、 CancellationPending プロパティをに設定し true ます。CancelAsync submits a request to terminate the pending background operation and sets the CancellationPending property to true.

を呼び出すと CancelAsync 、ワーカーメソッドは実行を停止して終了することができます。When you call CancelAsync, your worker method has an opportunity to stop its execution and exit. ワーカーコードは、プロパティを定期的にチェックして、 CancellationPending がに設定されているかどうかを確認する必要があり true ます。The worker code should periodically check the CancellationPending property to see if it has been set to true.

注意事項

DoWorkキャンセル要求が行われ、ポーリングループがに設定されていない可能性があるため、イベントハンドラーのコードが処理を終了する可能性があることに注意して CancellationPending true ください。Be aware that your code in the DoWork event handler may finish its work as a cancellation request is being made, and your polling loop may miss CancellationPending being set to true. この場合、 Cancelled System.ComponentModel.RunWorkerCompletedEventArgs RunWorkerCompleted true キャンセル要求が行われた場合でも、イベントハンドラーののフラグはに設定されません。In this case, the Cancelled flag of System.ComponentModel.RunWorkerCompletedEventArgs in your RunWorkerCompleted event handler will not be set to true, even though a cancellation request was made. この状況は 競合状態 と呼ばれ、マルチスレッドプログラミングの一般的な問題です。This situation is called a race condition and is a common concern in multithreaded programming. マルチスレッドのデザインの問題の詳細については、「 マネージスレッド処理のベストプラクティス」を参照してください。For more information about multithreading design issues, see Managed Threading Best Practices.

適用対象