AsyncTask.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 dessa tarefa.
[Android.Runtime.Register("cancel", "(Z)Z", "")]
public bool Cancel(bool mayInterruptIfRunning);
[<Android.Runtime.Register("cancel", "(Z)Z", "")>]
member this.Cancel : bool -> bool
Parâmetros
- mayInterruptIfRunning
- Boolean
true se o thread que executa essa tarefa deve ser interrompido; caso contrário, as tarefas em andamento têm permissão para serem concluídas.
Retornos
false se a tarefa não pôde ser cancelada, normalmente porque ela já foi concluída normalmente; true caso contrário,
- Atributos
Comentários
Tenta cancelar a execução dessa tarefa. Essa tentativa falhará se a tarefa já tiver sido concluída, já tiver sido cancelada ou não puder ser cancelada por algum outro motivo. Se tiver êxito e essa tarefa não tiver sido iniciada quando cancel for chamada, essa tarefa nunca deverá ser executada. Se a tarefa já tiver sido iniciada, o mayInterruptIfRunning parâmetro determinará se o thread que está executando essa tarefa deve ser interrompido na tentativa de interromper a tarefa.
Chamar esse método resultará em #onCancelled(Object) ser invocado no thread da interface do usuário após #doInBackground(Object[]) o retorno. Chamar esse método garante que onPostExecute(Object) nunca seja invocado posteriormente, mesmo que cancel retorne false, mas #onPostExecute ainda não foi executado. Para concluir a tarefa o mais cedo possível, verifique #isCancelled() periodicamente de #doInBackground(Object[]).
Isso só solicita cancelamento. Ele nunca aguarda que uma tarefa em segundo plano em execução seja encerrada, mesmo que mayInterruptIfRunning seja verdadeira.
Java documentação para android.os.AsyncTask.cancel(boolean).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.