Timer.ScheduleAtFixedRate 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.
Surcharges
| Nom | Description |
|---|---|
| ScheduleAtFixedRate(TimerTask, Date, Int64) |
Planifie la tâche spécifiée pour une exécution à taux fixe répété, en commençant à l’heure spécifiée. |
| ScheduleAtFixedRate(TimerTask, Int64, Int64) |
Planifie la tâche spécifiée pour une exécution à taux fixe répété, en commençant après le délai spécifié. |
ScheduleAtFixedRate(TimerTask, Date, Int64)
Planifie la tâche spécifiée pour une exécution à taux fixe répété, en commençant à l’heure spécifiée.
[Android.Runtime.Register("scheduleAtFixedRate", "(Ljava/util/TimerTask;Ljava/util/Date;J)V", "GetScheduleAtFixedRate_Ljava_util_TimerTask_Ljava_util_Date_JHandler")]
public virtual void ScheduleAtFixedRate(Java.Util.TimerTask? task, Java.Util.Date? firstTime, long period);
[<Android.Runtime.Register("scheduleAtFixedRate", "(Ljava/util/TimerTask;Ljava/util/Date;J)V", "GetScheduleAtFixedRate_Ljava_util_TimerTask_Ljava_util_Date_JHandler")>]
abstract member ScheduleAtFixedRate : Java.Util.TimerTask * Java.Util.Date * int64 -> unit
override this.ScheduleAtFixedRate : Java.Util.TimerTask * Java.Util.Date * int64 -> unit
Paramètres
- task
- TimerTask
tâche à planifier.
- firstTime
- Date
Première fois à laquelle la tâche doit être exécutée.
- period
- Int64
temps en millisecondes entre les exécutions de tâches successives.
- Attributs
Exceptions
si when.getTime() ou period <= 0.
si l’opération Timer a été annulée ou si la tâche a été planifiée ou annulée.
Remarques
Planifie la tâche spécifiée pour une exécution à taux fixe répété, en commençant à l’heure spécifiée. Les exécutions suivantes ont lieu à intervalles réguliers environ, séparées par la période spécifiée.
Dans l’exécution à taux fixe, chaque exécution est planifiée par rapport à l’heure d’exécution planifiée de l’exécution initiale. Si une exécution est retardée pour une raison quelconque (comme le garbage collection ou une autre activité en arrière-plan), deux exécutions ou plus se produisent rapidement pour « rattraper ». À long terme, la fréquence d’exécution sera exactement la réciproque de la période spécifiée (en supposant que l’horloge système sous-jacente Object.wait(long) est exacte). Par conséquent, si la première fois planifiée se trouve dans le passé, toutes les exécutions « manquées » seront planifiées pour une exécution immédiate de « rattrapage ».
L’exécution à taux fixe est appropriée pour les activités récurrentes qui sont sensibles à l’heure absolue , telles que l’anneau d’un chime toutes les heures sur l’heure, ou l’exécution d’une maintenance planifiée tous les jours à un moment donné. Il est également approprié pour les activités récurrentes où le temps total d’exécution d’un nombre fixe d’exécutions est important, par exemple un minuteur de compte à rebours qui est coché une fois par seconde pendant dix secondes. Enfin, l’exécution à taux fixe est appropriée pour planifier plusieurs tâches de minuteur répétées qui doivent rester synchronisées entre elles.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
S’applique à
ScheduleAtFixedRate(TimerTask, Int64, Int64)
Planifie la tâche spécifiée pour une exécution à taux fixe répété, en commençant après le délai spécifié.
[Android.Runtime.Register("scheduleAtFixedRate", "(Ljava/util/TimerTask;JJ)V", "GetScheduleAtFixedRate_Ljava_util_TimerTask_JJHandler")]
public virtual void ScheduleAtFixedRate(Java.Util.TimerTask? task, long delay, long period);
[<Android.Runtime.Register("scheduleAtFixedRate", "(Ljava/util/TimerTask;JJ)V", "GetScheduleAtFixedRate_Ljava_util_TimerTask_JJHandler")>]
abstract member ScheduleAtFixedRate : Java.Util.TimerTask * int64 * int64 -> unit
override this.ScheduleAtFixedRate : Java.Util.TimerTask * int64 * int64 -> unit
Paramètres
- task
- TimerTask
tâche à planifier.
- delay
- Int64
retard en millisecondes avant l’exécution de la tâche.
- period
- Int64
temps en millisecondes entre les exécutions de tâches successives.
- Attributs
Exceptions
si delay ou period <= 0.
si l’opération Timer a été annulée ou si la tâche a été planifiée ou annulée.
Remarques
Planifie la tâche spécifiée pour une exécution à taux fixe répété, en commençant après le délai spécifié. Les exécutions suivantes ont lieu à intervalles réguliers environ, séparées par la période spécifiée.
Dans l’exécution à taux fixe, chaque exécution est planifiée par rapport à l’heure d’exécution planifiée de l’exécution initiale. Si une exécution est retardée pour une raison quelconque (comme le garbage collection ou une autre activité en arrière-plan), deux exécutions ou plus se produisent rapidement pour « rattraper ». À long terme, la fréquence d’exécution sera exactement la réciproque de la période spécifiée (en supposant que l’horloge système sous-jacente Object.wait(long) est exacte).
L’exécution à taux fixe est appropriée pour les activités récurrentes qui sont sensibles à l’heure absolue , telles que l’anneau d’un chime toutes les heures sur l’heure, ou l’exécution d’une maintenance planifiée tous les jours à un moment donné. Il est également approprié pour les activités récurrentes où le temps total d’exécution d’un nombre fixe d’exécutions est important, par exemple un minuteur de compte à rebours qui est coché une fois par seconde pendant dix secondes. Enfin, l’exécution à taux fixe est appropriée pour planifier plusieurs tâches de minuteur répétées qui doivent rester synchronisées entre elles.
Java documentation pour java.util.Timer.scheduleAtFixedRate(java.util.TimerTask, long, long).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.