Поделиться через


AsyncTask.Cancel(Boolean) Метод

Определение

Пытается отменить выполнение этой задачи.

[Android.Runtime.Register("cancel", "(Z)Z", "")]
public bool Cancel (bool mayInterruptIfRunning);
[<Android.Runtime.Register("cancel", "(Z)Z", "")>]
member this.Cancel : bool -> bool

Параметры

mayInterruptIfRunning
Boolean

true Значение

Возвращаемое значение

false Значение , если задача не может быть отменена, как правило, так как она уже завершена; true иначе

Атрибуты

Комментарии

Пытается отменить выполнение этой задачи. Эта попытка завершится ошибкой, если задача уже завершена, уже отменена или не может быть отменена по какой-либо другой причине. Если эта задача не запущена при cancel вызове, эта задача никогда не должна выполняться. Если задача уже запущена, параметр определяет, должен ли поток, выполняющий эту задачу, mayInterruptIfRunning прервать попытку остановить задачу.

Вызов этого метода приведет к #onCancelled(Object) вызову потока пользовательского интерфейса после #doInBackground(Object[]) возврата. Вызов этого метода гарантирует, что onPostExecute(Object) никогда не вызывается впоследствии, даже если cancel возвращает значение false, но #onPostExecute еще не выполняется. Чтобы завершить задачу как можно раньше, периодически проверяйте #isCancelled() из #doInBackground(Object[]).

Это только запрашивает отмену. Она никогда не ожидает завершения выполнения фоновой задачи, даже если mayInterruptIfRunning значение true.

Документация по Java для android.os.AsyncTask.cancel(boolean).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к