AsyncTask.Cancel(Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Versucht, die Ausführung dieser Aufgabe abzubrechen.
[Android.Runtime.Register("cancel", "(Z)Z", "")]
public bool Cancel (bool mayInterruptIfRunning);
[<Android.Runtime.Register("cancel", "(Z)Z", "")>]
member this.Cancel : bool -> bool
Parameter
- mayInterruptIfRunning
- Boolean
true
wenn der Thread, der diese Aufgabe ausführt, unterbrochen werden soll; andernfalls können laufende Vorgänge abgeschlossen werden.
Gibt zurück
false
wenn der Vorgang nicht abgebrochen werden konnte, in der Regel weil er bereits normal abgeschlossen wurde; true
sonst
- Attribute
Hinweise
Versucht, die Ausführung dieser Aufgabe abzubrechen. Dieser Versuch schlägt fehl, wenn die Aufgabe bereits abgeschlossen wurde, bereits abgebrochen wurde oder aus einem anderen Grund nicht abgebrochen werden konnte. Wenn die Aufgabe erfolgreich war und diese Aufgabe beim Aufruf nicht gestartet cancel
wurde, sollte diese Aufgabe nie ausgeführt werden. Wenn die Aufgabe bereits gestartet wurde, bestimmt der mayInterruptIfRunning
Parameter, ob der Thread, der diese Aufgabe ausführt, unterbrochen werden soll, um die Aufgabe zu beenden.
Das Aufrufen dieser Methode führt dazu #onCancelled(Object)
, dass nach Rückgaben im UI-Thread #doInBackground(Object[])
aufgerufen wird. Durch Aufrufen dieser Methode wird sichergestellt, dass onPostExecute(Object) nie später aufgerufen wird, auch wenn cancel
"false" zurückgegeben wird, aber #onPostExecute
noch nicht ausgeführt wurde. Um den Vorgang so früh wie möglich abzuschließen, überprüfen Sie #isCancelled()
regelmäßig von #doInBackground(Object[])
.
Dies fordert nur den Abbruch an. Es wartet niemals, bis eine ausgeführte Hintergrundaufgabe beendet wird, auch wenn mayInterruptIfRunning
dies wahr ist.
Java-Dokumentation für android.os.AsyncTask.cancel(boolean)
.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.