Compartilhar via


AsyncTask.Cancel(Boolean) Método

Definição

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.

Aplica-se a