語言

ForkJoinTask.Cancel(Boolean) 方法

定義

試圖取消執行此任務。

[Android.Runtime.Register("cancel", "(Z)Z", "GetCancel_ZHandler")]
public virtual bool Cancel(bool mayInterruptIfRunning);
[<Android.Runtime.Register("cancel", "(Z)Z", "GetCancel_ZHandler")>]
abstract member Cancel : bool -> bool
override this.Cancel : bool -> bool

參數

mayInterruptIfRunning
Boolean

此值在預設實作中無影響,因為中斷不用於控制取消。

傳回

true 如果這個任務現在被取消了

實作

屬性

備註

試圖取消執行此任務。 若任務已完成或因其他原因無法取消,此嘗試將失敗。 若成功且呼叫時該任務尚未開始 cancel ,則該任務的執行會被抑制。 此方法成功返回後,除非中間呼叫 ,#reinitialize否則後續呼叫 #isCancelled、 #isDone、 cancel 會回傳true,呼叫 #join 及相關方法將導致 。CancellationException

此方法可在子類別中覆寫,但若如此,仍必須確保這些性質成立。 特別是,方法 cancel 本身不得拋出例外。

此方法設計為由 <em>其他<任務> 呼叫。 要終止目前的任務,你可以直接回傳或拋出未被勾選的例外,或是呼叫 #completeExceptionally(Throwable)。

Java 文件 java.util.concurrent.ForkJoinTask.cancel(boolean)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於