ActorBase.RegisterReminderAsync(String, Byte[], TimeSpan, TimeSpan) Method

Reference

Definition

Namespace:: Microsoft.ServiceFabric.Actors.Runtime

Assembly:: Microsoft.ServiceFabric.Actors.dll

Package:: Microsoft.ServiceFabric.Actors v6.1.1583

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Registers a reminder with the actor.

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)

Parameters

reminderName: String

The name of the reminder to register. The name must be unique per actor.

state: Byte[]

User state passed to the reminder invocation.

dueTime: TimeSpan

The amount of time to delay before invoking the reminder for the first time. Specify negative one (-1) milliseconds to disable invocation. Specify zero (0) to invoke the reminder immediately after registration.

period: TimeSpan

The time interval between reminder invocations after the first invocation. Specify negative one (-1) milliseconds to disable periodic invocation.

Returns

Task<IActorReminder>

A task that represents the asynchronous registration operation. The result of the task provides information about the registered reminder and is used to unregister the reminder using UnregisterReminderAsync(IActorReminder).

Remarks

The class deriving from ActorBase must implement IRemindable to consume reminder invocations. Multiple reminders can be registered at any time, uniquely identified by reminderName. Existing reminders can also be updated by calling this method again. Reminder invocations are synchronized both with other reminders and other actor method callbacks.

Applies to

مشاركة عبر