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.