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 desta 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 poderão ser concluídas.
Retornos
false
se a tarefa não pôde ser cancelada, normalmente porque já foi concluída normalmente; true
caso contrário
- Atributos
Comentários
Tenta cancelar a execução desta 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 for bem-sucedida 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 executa 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[])
retornos. Chamar esse método garante que onPostExecute(Object) nunca seja invocado subsequentemente, mesmo se cancel
retornar false, mas #onPostExecute
ainda não tiver sido executado. Para concluir a tarefa o mais cedo possível, verifique #isCancelled()
periodicamente a partir de #doInBackground(Object[])
.
Isso só solicita cancelamento. Ele nunca espera que uma tarefa em segundo plano em execução seja encerrada, mesmo que mayInterruptIfRunning
seja verdadeira.
Documentação Java para android.os.AsyncTask.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.