語言

IScheduledExecutorService.ScheduleAtFixedRate 方法

定義

提交一個週期性行動,該動作在給定的初始延遲後先啟用,隨後在指定期間內生效;也就是說,執行會在 initialDelay之後開始,接著 initialDelay + period,然後 initialDelay + 2 * period,依此類推。

[Android.Runtime.Register("scheduleAtFixedRate", "(Ljava/lang/Runnable;JJLjava/util/concurrent/TimeUnit;)Ljava/util/concurrent/ScheduledFuture;", "GetScheduleAtFixedRate_Ljava_lang_Runnable_JJLjava_util_concurrent_TimeUnit_Handler:Java.Util.Concurrent.IScheduledExecutorServiceInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Util.Concurrent.IScheduledFuture? ScheduleAtFixedRate(Java.Lang.IRunnable? command, long initialDelay, long period, Java.Util.Concurrent.TimeUnit? unit);
[<Android.Runtime.Register("scheduleAtFixedRate", "(Ljava/lang/Runnable;JJLjava/util/concurrent/TimeUnit;)Ljava/util/concurrent/ScheduledFuture;", "GetScheduleAtFixedRate_Ljava_lang_Runnable_JJLjava_util_concurrent_TimeUnit_Handler:Java.Util.Concurrent.IScheduledExecutorServiceInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ScheduleAtFixedRate : Java.Lang.IRunnable * int64 * int64 * Java.Util.Concurrent.TimeUnit -> Java.Util.Concurrent.IScheduledFuture

參數

command
IRunnable

執行任務

initialDelay
Int64

延遲首次處決的時間

period
Int64

連續執行死刑之間的期間

unit
TimeUnit

初始Delay與週期參數的時間單位

傳回

一個預定未來,代表等待完成一系列重複任務。 未來 Future#get() get() 的方法永遠不會正常返回,且在任務取消或任務執行異常終止時會拋出例外。

屬性

例外狀況

如果任務無法排程執行

若指令為空

若週期小於或等於零

備註

提交一個週期性行動,該動作在給定的初始延遲後先啟用,隨後在指定期間內生效;也就是說,執行會在 initialDelay之後開始,接著 initialDelay + period,然後 initialDelay + 2 * period,依此類推。

任務執行序列會無限持續,直到以下其中一個例外完成發生: <ul><li>該任務是 Future#cancel,透過回傳的 Future 明確取消。 <li>執行人終止,任務也會被取消。 <李>執行任務時會拋出例外。 此時 Future#get() get 呼叫返回的未來會拋出 ExecutionException,並以例外為原因。 </ul> 後續處決被壓制。 後續通話 Future#isDone isDone() 將返回 true。

若任何任務執行時間超過其週期,後續執行可能會延遲開始,但不會同時執行。

Java 文件 java.util.concurrent.ScheduledExecutorService.scheduleAtFixedRate(java.lang.Runnable, long, long, java.util.concurrent.TimeUnit)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於