Partager via


ForkJoinTask.Cancel(Boolean) Méthode

Définition

Tente d’annuler l’exécution de cette tâche.

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

Paramètres

mayInterruptIfRunning
Boolean

cette valeur n’a aucun effet dans l’implémentation par défaut, car les interruptions ne sont pas utilisées pour contrôler l’annulation.

Retours

true si cette tâche est désormais annulée

Implémente

Attributs

Remarques

Tente d’annuler l’exécution de cette tâche. Cette tentative échoue si la tâche est déjà terminée ou n’a pas pu être annulée pour une autre raison. Si elle réussit, et que cette tâche n’a pas démarré lorsqu’elle cancel est appelée, l’exécution de cette tâche est supprimée. Une fois cette méthode retournée avec succès, sauf s’il existe un appel intermédiaire à #reinitialize, les appels suivants à #isCancelled, #isDoneet cancel retourne et les true appels vers #join et les méthodes associées entraîneront CancellationException.

Cette méthode peut être substituée dans les sous-classes, mais si c’est le cas, elle doit toujours s’assurer que ces propriétés sont conservées. En particulier, la cancel méthode elle-même ne doit pas lever d’exceptions.

Cette méthode est conçue pour être appelée par <d’autres<> tâches em/em>. Pour terminer la tâche actuelle, vous pouvez simplement retourner ou lever une exception non cochée de sa méthode de calcul, ou appeler #completeExceptionally(Throwable).

Documentation Java pour java.util.concurrent.ForkJoinTask.cancel(boolean).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à