ForkJoinTask.Cancel(Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
, #isDone
et 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.