CancellationTokenSource.TryReset Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Tenta redefinir a CancellationTokenSource operação a ser usada para uma operação não relacionada.
public:
bool TryReset();public bool TryReset ();member this.TryReset : unit -> boolPublic Function TryReset () As BooleanRetornos
true se o CancellationTokenSource cancelamento não foi solicitado e pode ter seu estado redefinido para ser reutilizado para uma operação subsequente; caso contrário, false.
Comentários
TryReset() destina-se a ser usado pelo único proprietário do CancellationTokenSource quando se sabe que:
- A operação com a qual o CancellationTokenSource foi usado foi concluída.
- Ninguém mais tentará cancelá-lo.
- Todos os registros restantes são incorretos.
Após uma redefinição bem-sucedida, esses registros não serão mais notificados para qualquer cancelamento subsequente do CancellationTokenSource; no entanto, se qualquer componente ainda tiver uma referência a isso CancellationTokenSource direta ou indiretamente por meio de uma CancellationToken distribuição dele, a sondagem por meio de sua referência mostrará o estado atual a qualquer momento após a redefinição, pois é a mesma instância. O uso de TryReset() simultaneamente com a solicitação de cancelamento não é thread-safe e pode resultar em TryReset() retorno true mesmo se o cancelamento já tiver sido solicitado. Além disso, isso pode fazer com que os registros não sejam invocados como parte da solicitação de cancelamento simultânea.