CancellationTokenSource.TryReset 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
嘗試重設 CancellationTokenSource ,以用於不相關的作業。
public:
bool TryReset();
public bool TryReset ();
member this.TryReset : unit -> bool
Public Function TryReset () As Boolean
傳回
true
CancellationTokenSource如果 尚未要求取消,而且可能會將其狀態重設重複使用於後續作業,則為 , false
否則為 。
備註
TryReset() 是要在知道時,由 的唯一擁有者 CancellationTokenSource 使用:
- 所使用的 作業 CancellationTokenSource 已完成。
- 沒有其他人會嘗試取消它。
- 任何剩餘的註冊都錯誤。
成功重設時,這類註冊將不再收到任何後續取消的 CancellationTokenSource 通知;不過,如果有任何元件仍透過從中傳回的 直接或間接 CancellationToken 保留此 CancellationTokenSource 的參考,則透過其參考輪詢會在重設為相同的實例之後隨時顯示目前狀態。 TryReset()同時對要求取消的使用不是安全線程,而且即使已要求取消,也可能會導致 TryReset() 傳回 true
。 此外,它可能會導致註冊不會在並行取消要求中叫用。