CancellationTokenSource.TryReset Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Próbuje zresetować element CancellationTokenSource , który ma zostać użyty do wykonania niepowiązanej operacji.
public:
bool TryReset();public bool TryReset ();member this.TryReset : unit -> boolPublic Function TryReset () As BooleanZwraca
trueCancellationTokenSource jeśli żądanie anulowania nie zostało anulowane i może zostać ponownie użyte do ponownego użycia dla kolejnej operacji; w przeciwnym razie false.
Uwagi
TryReset() jest przeznaczony do wykorzystania przez jedynego CancellationTokenSource właściciela, gdy wiadomo, że:
- Operacja, z którą CancellationTokenSource została użyta, została ukończona.
- Nikt inny nie spróbuje go anulować.
- Wszelkie pozostałe rejestracje są błędne.
Po pomyślnym zresetowaniu takie rejestracje nie będą już powiadamiane o kolejnym anulowaniu CancellationTokenSource; jednak jeśli jakikolwiek składnik nadal zawiera odwołanie do tego CancellationTokenSource bezpośrednio lub pośrednio za pośrednictwem rozdawanego CancellationToken z niego, sondowanie za pośrednictwem odwołania pokaże bieżący stan w dowolnym momencie po zresetowaniu, ponieważ jest to to samo wystąpienie. Użycie równoczesnego TryReset() żądania anulowania nie jest bezpieczne wątkowo i może spowodować TryReset() zwrócenie true nawet wtedy, gdy zostało już zażądane anulowanie. Ponadto może to spowodować, że rejestracje nie są wywoływane w ramach współbieżnego żądania anulowania.