Freigeben über


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

Definition

Registriert eine Erinnerung beim Akteur.

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)

Parameter

reminderName
String

Der Name der zu registrierenden Erinnerung. Der Name muss pro Akteur eindeutig sein.

state
Byte[]

Der Benutzerstatus wurde an den Erinnerungsaufruf übergeben.

dueTime
TimeSpan

Die Zeitspanne, die verzögert werden muss, bevor die Erinnerung zum ersten Mal aufgerufen wird. Geben Sie negative eine (-1) Millisekunden an, um den Aufruf zu deaktivieren. Geben Sie null (0) an, um die Erinnerung unmittelbar nach der Registrierung aufzurufen.

period
TimeSpan

Das Zeitintervall zwischen Erinnerungsaufrufen nach dem ersten Aufruf. Geben Sie negative eine (-1) Millisekunde an, um den regelmäßigen Aufruf zu deaktivieren.

Gibt zurück

Eine Aufgabe, die den asynchronen Registrierungsvorgang darstellt. Das Ergebnis der Aufgabe enthält Informationen zur registrierten Erinnerung und wird verwendet, um die Registrierung der Erinnerung mithilfe von UnregisterReminderAsync(IActorReminder)aufzuheben.

Hinweise

Die von ActorBase abgeleitete Klasse muss implementiert IRemindable werden, um Erinnerungsaufrufe zu nutzen. Mehrere Erinnerungen können jederzeit registriert werden, eindeutig identifiziert durch reminderName. Vorhandene Erinnerungen können auch aktualisiert werden, indem Sie diese Methode erneut aufrufen. Erinnerungsaufrufe werden sowohl mit anderen Erinnerungen als auch mit Rückrufen anderer Akteurmethoden synchronisiert.

Gilt für: