TimeProvider.CreateTimer(TimerCallback, Object, TimeSpan, TimeSpan) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
public:
virtual System::Threading::ITimer ^ CreateTimer(System::Threading::TimerCallback ^ callback, System::Object ^ state, TimeSpan dueTime, TimeSpan period);public virtual System.Threading.ITimer CreateTimer(System.Threading.TimerCallback callback, object? state, TimeSpan dueTime, TimeSpan period);abstract member CreateTimer : System.Threading.TimerCallback * obj * TimeSpan * TimeSpan -> System.Threading.ITimer
override this.CreateTimer : System.Threading.TimerCallback * obj * TimeSpan * TimeSpan -> System.Threading.ITimerPublic Overridable Function CreateTimer (callback As TimerCallback, state As Object, dueTime As TimeSpan, period As TimeSpan) As ITimerParâmetros
- callback
- TimerCallback
Um delegado que representa um método a ser executado quando o temporizador é acionado. O método especificado para retorno de chamada deve ser reentrante, pois pode ser invocado simultaneamente em dois threads se o temporizador for acionado novamente antes ou enquanto um retorno de chamada anterior ainda estiver sendo tratado.
- state
- Object
Um objeto a ser passado para o callback. Isso pode ser nulo.
- dueTime
- TimeSpan
A quantidade de tempo a ser atrasada antes callback é invocada. Especifique InfiniteTimeSpan para impedir que o temporizador seja iniciado. Especifique Zero para iniciar o temporizador imediatamente.
- period
- TimeSpan
O intervalo de tempo entre invocações de callback. Especifique InfiniteTimeSpan para desabilitar a sinalização periódica.
Retornos
A instância recém-criada ITimer .
Exceções
callback é nulo.
O número de milissegundos no valor de dueTime ou é negativo e não igual a Infinite, ou é maior que MaxValueperiod .
Comentários
O delegado especificado pelo parâmetro de retorno de chamada é invocado uma vez após dueTime o decorrido e, depois disso, cada vez que o period intervalo de tempo passa.
Se dueTime for zero, o retorno de chamada será invocado imediatamente. Se dueTime for -1 milissegundos, callback não será invocado; o temporizador será desabilitado, mas poderá ser habilitado novamente chamando o Change(TimeSpan, TimeSpan) método.
Se period for 0 ou -1 milissegundos e dueTime for positivo, callback será invocado uma vez; o comportamento periódico do temporizador será desabilitado, mas poderá ser reabilitado usando o Change(TimeSpan, TimeSpan) método.
A instância de retorno ITimer será implicitamente enraizada enquanto o temporizador ainda estiver agendado.
CreateTimer(TimerCallback, Object, TimeSpan, TimeSpan) captura o ExecutionContext e armazena que com o ITimer para uso ao invocar callback cada vez que ele é chamado. Essa captura pode ser suprimida com SuppressFlow().
