ActorBase.RegisterReminderAsync(String, Byte[], TimeSpan, TimeSpan) Método

Definição

Namespace:

Microsoft.ServiceFabric.Actors.Runtime

Assembly:

Microsoft.ServiceFabric.Actors.dll

Pacote:

Microsoft.ServiceFabric.Actors v6.1.1583

Registra um lembrete com o ator.

protected System.Threading.Tasks.Task<Microsoft.ServiceFabric.Actors.Runtime.IActorReminder> RegisterReminderAsync (string reminderName, byte[] state, TimeSpan dueTime, TimeSpan period);

member this.RegisterReminderAsync : string * byte[] * TimeSpan * TimeSpan -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Actors.Runtime.IActorReminder>

Protected Function RegisterReminderAsync (reminderName As String, state As Byte(), dueTime As TimeSpan, period As TimeSpan) As Task(Of IActorReminder)

Parâmetros

reminderName

String

O nome do lembrete a ser registrado. O nome deve ser exclusivo por ator.

state

Byte[]

Estado do usuário passado para a invocação de lembrete.

dueTime

TimeSpan

A quantidade de tempo a atrasar antes de invocar o lembrete pela primeira vez. Especifique um (-1) milissegundos negativos para desabilitar a invocação. Especifique zero (0) para invocar o lembrete imediatamente após o registro.

period

TimeSpan

O intervalo de tempo entre invocações de lembrete após a primeira invocação. Especifique um (-1) milissegundos negativos para desabilitar a invocação periódica.

Retornos

Task<IActorReminder>

Uma tarefa que representa a operação de registro assíncrona. O resultado da tarefa fornece informações sobre o lembrete registrado e é usado para cancelar o registro do lembrete usando UnregisterReminderAsync(IActorReminder).

Comentários

A classe derivada de ActorBase deve implementar IRemindable para consumir invocações de lembrete. Vários lembretes podem ser registrados a qualquer momento, identificados exclusivamente por reminderName. Lembretes existentes também podem ser atualizados chamando esse método novamente. As invocações de lembrete são sincronizadas com outros lembretes e outros retornos de chamada de método de ator.