GrainBaseExtensions.RegisterGrainTimer 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.
Sobrecargas
| Nome | Description |
|---|---|
| RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, GrainTimerCreationOptions) |
Cria um temporizador de grãos. |
| RegisterGrainTimer(IGrainBase, Func<Task>, GrainTimerCreationOptions) | |
| RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, TimeSpan, TimeSpan) |
Cria um temporizador de grãos. |
| RegisterGrainTimer(IGrainBase, Func<Task>, TimeSpan, TimeSpan) |
Cria um temporizador de grãos. |
| RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, GrainTimerCreationOptions) |
Cria um temporizador de grãos. |
| RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, GrainTimerCreationOptions) | |
| RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, TimeSpan, TimeSpan) |
Cria um temporizador de grãos. |
| RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, TimeSpan, TimeSpan) |
Cria um temporizador de grãos. |
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, GrainTimerCreationOptions)
Cria um temporizador de grãos.
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer(this Orleans.IGrainBase grain, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, Orleans.Runtime.GrainTimerCreationOptions options);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of CancellationToken, Task), options As GrainTimerCreationOptions) As IGrainTimer
Parâmetros
- grain
- IGrainBase
A instância de grãos.
- callback
- Func<CancellationToken,Task>
O retorno de chamada do temporizador, que será invocado sempre que o temporizador for devido.
- options
- GrainTimerCreationOptions
As opções para criar o temporizador.
Retornos
A instância IGrainTimer que representa o temporizador.
Comentários
Os temporizadores de grãos não mantêm os grãos ativos por padrão. Definir KeepAlive para true faz com que cada tique de temporizador estenda o tempo de vida da ativação de grãos. Se os tiques do temporizador não forem frequentes, o grão ainda poderá ser desativado devido à ociosidade. Quando um grão é desativado, todos os temporizadores ativos são descartados.
Até que o Task retornado do retorno de chamada seja resolvido, o próximo tique do temporizador não será agendado. Ou seja, um retorno de chamada de temporizador nunca será executado simultaneamente consigo mesmo. Se Interleave estiver definido como true, o retorno de chamada do temporizador poderá ser intercalada com outras chamadas de método de grãos e outros temporizadores. Se Interleave estiver definido como false, o retorno de chamada do temporizador respeitará a configuração de reentração do grão, assim como uma chamada de método de grão típico.
O temporizador pode ser interrompido a qualquer momento chamando o método Dispose() do IGrainTimer. Descartar um temporizador impede que mais tiques de temporizador sejam agendados.
O tempo de conclusão do tempo e o período podem ser atualizados chamando seu método Change(TimeSpan, TimeSpan). Sempre que o temporizador for atualizado, o próximo tique do temporizador será agendado com base no tempo de conclusão atualizado. Os tiques subsequentes serão agendados após o período atualizado decorrido. Observe que esse comportamento é o mesmo que o método Change(TimeSpan, TimeSpan).
As exceções geradas do retorno de chamada serão registradas, mas não impedirão que o próximo tique de temporizador seja enfileirado.
Aplica-se a
RegisterGrainTimer(IGrainBase, Func<Task>, GrainTimerCreationOptions)
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer(this Orleans.IGrainBase grain, Func<System.Threading.Tasks.Task> callback, Orleans.Runtime.GrainTimerCreationOptions options);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.Tasks.Task> * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of Task), options As GrainTimerCreationOptions) As IGrainTimer
Parâmetros
- grain
- IGrainBase
- options
- GrainTimerCreationOptions
Retornos
Aplica-se a
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, TimeSpan, TimeSpan)
Cria um temporizador de grãos.
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer(this Orleans.IGrainBase grain, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, TimeSpan dueTime, TimeSpan period);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of CancellationToken, Task), dueTime As TimeSpan, period As TimeSpan) As IGrainTimer
Parâmetros
- grain
- IGrainBase
A instância de grãos.
- callback
- Func<CancellationToken,Task>
O retorno de chamada do temporizador, que será invocado sempre que o temporizador for devido.
- dueTime
- TimeSpan
Um TimeSpan que representa a quantidade de tempo a ser atrasada antes de invocar o método de retorno de chamada especificado quando o IGrainTimer foi construído. 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 do método de retorno de chamada especificado quando o IGrainTimer foi construído. Especifique InfiniteTimeSpan para desabilitar a sinalização periódica.
Retornos
A instância IGrainTimer que representa o temporizador.
Aplica-se a
RegisterGrainTimer(IGrainBase, Func<Task>, TimeSpan, TimeSpan)
Cria um temporizador de grãos.
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer(this Orleans.IGrainBase grain, Func<System.Threading.Tasks.Task> callback, TimeSpan dueTime, TimeSpan period);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.Tasks.Task> * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of Task), dueTime As TimeSpan, period As TimeSpan) As IGrainTimer
Parâmetros
- grain
- IGrainBase
A instância de grãos.
O retorno de chamada do temporizador, que será invocado sempre que o temporizador for devido.
- dueTime
- TimeSpan
Um TimeSpan que representa a quantidade de tempo a ser atrasada antes de invocar o método de retorno de chamada especificado quando o IGrainTimer foi construído. 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 do método de retorno de chamada especificado quando o IGrainTimer foi construído. Especifique InfiniteTimeSpan para desabilitar a sinalização periódica.
Retornos
A instância IGrainTimer que representa o temporizador.
Comentários
Os temporizadores de grãos não mantêm os grãos ativos por padrão. Definir KeepAlive para true faz com que cada tique de temporizador estenda o tempo de vida da ativação de grãos. Se os tiques do temporizador não forem frequentes, o grão ainda poderá ser desativado devido à ociosidade. Quando um grão é desativado, todos os temporizadores ativos são descartados.
Até que o Task retornado do retorno de chamada seja resolvido, o próximo tique do temporizador não será agendado. Ou seja, um retorno de chamada de temporizador nunca será executado simultaneamente consigo mesmo. Se Interleave estiver definido como true, o retorno de chamada do temporizador poderá ser intercalada com outras chamadas de método de grãos e outros temporizadores. Se Interleave estiver definido como false, o retorno de chamada do temporizador respeitará a configuração de reentração do grão, assim como uma chamada de método de grão típico.
O temporizador pode ser interrompido a qualquer momento chamando o método Dispose() do IGrainTimer. Descartar um temporizador impede que mais tiques de temporizador sejam agendados.
O tempo de conclusão do tempo e o período podem ser atualizados chamando seu método Change(TimeSpan, TimeSpan). Sempre que o temporizador for atualizado, o próximo tique do temporizador será agendado com base no tempo de conclusão atualizado. Os tiques subsequentes serão agendados após o período atualizado decorrido. Observe que esse comportamento é o mesmo que o método Change(TimeSpan, TimeSpan).
As exceções geradas do retorno de chamada serão registradas, mas não impedirão que o próximo tique de temporizador seja enfileirado.
Aplica-se a
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, GrainTimerCreationOptions)
Cria um temporizador de grãos.
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState>(this Orleans.IGrainBase grain, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, TState state, Orleans.Runtime.GrainTimerCreationOptions options);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task> * 'State * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, CancellationToken, Task), state As TState, options As GrainTimerCreationOptions) As IGrainTimer
Parâmetros de tipo
- TState
O tipo do parâmetro state.
Parâmetros
- grain
- IGrainBase
- callback
- Func<TState,CancellationToken,Task>
O retorno de chamada do temporizador, que será invocado sempre que o temporizador for devido.
- state
- TState
O estado passado para o retorno de chamada.
- options
- GrainTimerCreationOptions
As opções para criar o temporizador.
Retornos
A instância IGrainTimer que representa o temporizador.
Comentários
Os temporizadores de grãos não mantêm os grãos ativos por padrão. Definir KeepAlive para true faz com que cada tique de temporizador estenda o tempo de vida da ativação de grãos. Se os tiques do temporizador não forem frequentes, o grão ainda poderá ser desativado devido à ociosidade. Quando um grão é desativado, todos os temporizadores ativos são descartados.
Até que o Task retornado do retorno de chamada seja resolvido, o próximo tique do temporizador não será agendado. Ou seja, um retorno de chamada de temporizador nunca será executado simultaneamente consigo mesmo. Se Interleave estiver definido como true, o retorno de chamada do temporizador poderá ser intercalada com outras chamadas de método de grãos e outros temporizadores. Se Interleave estiver definido como false, o retorno de chamada do temporizador respeitará a configuração de reentração do grão, assim como uma chamada de método de grão típico.
O temporizador pode ser interrompido a qualquer momento chamando o método Dispose() do IGrainTimer. Descartar um temporizador impede que mais tiques de temporizador sejam agendados.
O tempo de conclusão do tempo e o período podem ser atualizados chamando seu método Change(TimeSpan, TimeSpan). Sempre que o temporizador for atualizado, o próximo tique do temporizador será agendado com base no tempo de conclusão atualizado. Os tiques subsequentes serão agendados após o período atualizado decorrido. Observe que esse comportamento é o mesmo que o método Change(TimeSpan, TimeSpan).
As exceções geradas do retorno de chamada serão registradas, mas não impedirão que o próximo tique de temporizador seja enfileirado.
Aplica-se a
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, GrainTimerCreationOptions)
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState>(this Orleans.IGrainBase grain, Func<TState,System.Threading.Tasks.Task> callback, TState state, Orleans.Runtime.GrainTimerCreationOptions options);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.Tasks.Task> * 'State * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, Task), state As TState, options As GrainTimerCreationOptions) As IGrainTimer
Parâmetros de tipo
- TState
O tipo do parâmetro state.
Parâmetros
- grain
- IGrainBase
- state
- TState
O estado passado para o retorno de chamada.
- options
- GrainTimerCreationOptions
Retornos
Aplica-se a
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, TimeSpan, TimeSpan)
Cria um temporizador de grãos.
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState>(this Orleans.IGrainBase grain, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, TState state, TimeSpan dueTime, TimeSpan period);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task> * 'State * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, CancellationToken, Task), state As TState, dueTime As TimeSpan, period As TimeSpan) As IGrainTimer
Parâmetros de tipo
- TState
O tipo do parâmetro state.
Parâmetros
- grain
- IGrainBase
A instância de grãos.
- callback
- Func<TState,CancellationToken,Task>
O retorno de chamada do temporizador, que será invocado sempre que o temporizador for devido.
- state
- TState
O estado passado para o retorno de chamada.
- dueTime
- TimeSpan
Um TimeSpan que representa a quantidade de tempo a ser atrasada antes de invocar o método de retorno de chamada especificado quando o IGrainTimer foi construído. 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 do método de retorno de chamada especificado quando o IGrainTimer foi construído. Especifique InfiniteTimeSpan para desabilitar a sinalização periódica.
Retornos
A instância IGrainTimer que representa o temporizador.
Aplica-se a
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, TimeSpan, TimeSpan)
Cria um temporizador de grãos.
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState>(this Orleans.IGrainBase grain, Func<TState,System.Threading.Tasks.Task> callback, TState state, TimeSpan dueTime, TimeSpan period);
static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.Tasks.Task> * 'State * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer
<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, Task), state As TState, dueTime As TimeSpan, period As TimeSpan) As IGrainTimer
Parâmetros de tipo
- TState
O tipo do parâmetro state.
Parâmetros
- grain
- IGrainBase
A instância de grãos.
O retorno de chamada do temporizador, que será invocado sempre que o temporizador for devido.
- state
- TState
O estado passado para o retorno de chamada.
- dueTime
- TimeSpan
Um TimeSpan que representa a quantidade de tempo a ser atrasada antes de invocar o método de retorno de chamada especificado quando o IGrainTimer foi construído. 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 do método de retorno de chamada especificado quando o IGrainTimer foi construído. Especifique InfiniteTimeSpan para desabilitar a sinalização periódica.
Retornos
A instância IGrainTimer que representa o temporizador.