ForkJoinTask.Cancel(Boolean) 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 cancelar a execução desta tarefa.
[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
Parâmetros
- mayInterruptIfRunning
- Boolean
Esse valor não tem efeito na implementação padrão porque as interrupções não são usadas para controlar o cancelamento.
Retornos
true
Se esta tarefa for cancelada
Implementações
- Atributos
Comentários
Tenta cancelar a execução desta tarefa. Essa tentativa falhará se a tarefa já tiver sido concluída ou não puder ser cancelada por algum outro motivo. Se for bem-sucedida e essa tarefa não tiver sido iniciada quando cancel
for chamada, a execução dessa tarefa será suprimida. Depois que esse método retornar com êxito, a menos que haja uma chamada interveniente para #reinitialize
, as chamadas subsequentes para #isCancelled
, #isDone
e cancel
retornarão true
e as chamadas para #join
e métodos relacionados resultarão em CancellationException
.
Esse método pode ser substituído em subclasses, mas em caso afirmativo, ainda deve garantir que essas propriedades sejam mantidas. Em particular, o cancel
método em si não deve lançar excepções.
Esse método foi projetado para ser invocado por <em>outras< tarefas/em> . Para encerrar a tarefa atual, você pode simplesmente retornar ou lançar uma exceção não verificada de seu método de computação ou invocar #completeExceptionally(Throwable)
.
Documentação Java para java.util.concurrent.ForkJoinTask.cancel(boolean)
.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.