Share via


FabricClient.ServiceManagementClient.RegisterServiceNotificationFilterAsync Methode

Definition

Überlädt

RegisterServiceNotificationFilterAsync(ServiceNotificationFilterDescription, TimeSpan, CancellationToken)

Registriert eine ServiceNotificationFilterDescription. Nimmt auch ein Timeoutintervall in Anspruch. Dies ist die maximale Zeit, die das System ermöglicht, diesen Vorgang fortzusetzen, bevor das vom Vorgang beobachtete Token und das Abbruchtoken zurückgegeben TimeoutException wird.

RegisterServiceNotificationFilterAsync(ServiceNotificationFilterDescription)

Registriert eine ServiceNotificationFilterDescription.

RegisterServiceNotificationFilterAsync(ServiceNotificationFilterDescription, TimeSpan, CancellationToken)

Registriert eine ServiceNotificationFilterDescription. Nimmt auch ein Timeoutintervall in Anspruch. Dies ist die maximale Zeit, die das System ermöglicht, diesen Vorgang fortzusetzen, bevor das vom Vorgang beobachtete Token und das Abbruchtoken zurückgegeben TimeoutException wird.

public System.Threading.Tasks.Task<long> RegisterServiceNotificationFilterAsync (System.Fabric.Description.ServiceNotificationFilterDescription description, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.RegisterServiceNotificationFilterAsync : System.Fabric.Description.ServiceNotificationFilterDescription * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Function RegisterServiceNotificationFilterAsync (description As ServiceNotificationFilterDescription, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of Long)

Parameter

description
ServiceNotificationFilterDescription

Die Beschreibung, die bestimmt, welche Änderungsereignisse des Dienstendpunkts über das ServiceNotificationFilterMatched Ereignis an diesen Client übermittelt werden sollen.

timeout
TimeSpan

Die maximal zulässige Zeit für die Verarbeitung der Anforderung, bevor TimeoutException ausgelöst wird.

cancellationToken
CancellationToken

Für die zukünftige Verwendung reserviert.

Gibt zurück

Ein Task , der den asynchronen Vorgang darstellt. Das Vorgangsergebnis ist eine ID, die dem registrierten ServiceNotificationFilterDescription entspricht, die verwendet werden kann, um die Registrierung desselben Filters über UnregisterServiceNotificationFilterAsync(Int64)aufzuheben.

Ausnahmen

Wenn description null ist.

Hinweise

Es gibt einen Cache mit Dienstendpunkten im Client, der durch Benachrichtigungen aktualisiert wird, und derselbe Cache wird verwendet, um beschwerdebasierte Lösungsanforderungen zu erfüllen (siehe ResolveServicePartitionAsync(Uri, ResolvedServicePartition)). Anwendungen, die sich sowohl für Benachrichtigungen registrieren als auch beschwerdebasierte Lösung auf demselben Client instance müssen normalerweise nur null für das Argument während der ResolvedServicePartition Lösung übergeben. Dadurch werden immer die Endpunkte im Clientcache zurückgegeben, die durch die neueste Benachrichtigung aktualisiert wurden. Der Benachrichtigungsmechanismus selbst hält den Clientcache auf dem neuesten Stand, wenn sich Die Dienstendpunkte ändern. Es ist nicht erforderlich, von einer ServiceNotification in eine ResolvedServicePartition zu konvertieren, um den Clientcache zu aktualisieren.

Gilt für:

RegisterServiceNotificationFilterAsync(ServiceNotificationFilterDescription)

public System.Threading.Tasks.Task<long> RegisterServiceNotificationFilterAsync (System.Fabric.Description.ServiceNotificationFilterDescription description);
member this.RegisterServiceNotificationFilterAsync : System.Fabric.Description.ServiceNotificationFilterDescription -> System.Threading.Tasks.Task<int64>
Public Function RegisterServiceNotificationFilterAsync (description As ServiceNotificationFilterDescription) As Task(Of Long)

Parameter

description
ServiceNotificationFilterDescription

Die Beschreibung, die bestimmt, welche Änderungsereignisse des Dienstendpunkts über das ServiceNotificationFilterMatched Ereignis an diesen Client übermittelt werden sollen.

Gibt zurück

Ein Task , der den asynchronen Vorgang darstellt. Das Vorgangsergebnis ist eine ID, die dem registrierten ServiceNotificationFilterDescription entspricht, die verwendet werden kann, um die Registrierung desselben Filters über UnregisterServiceNotificationFilterAsync(Int64)aufzuheben.

Ausnahmen

Wenn description null ist.

Hinweise

Das Standardtimeout beträgt eine Minute, für die das System den Vorgang fortsetzen kann, bevor zurückgegeben TimeoutExceptionwird.

Es gibt einen Cache mit Dienstendpunkten im Client, der durch Benachrichtigungen aktualisiert wird, und derselbe Cache wird verwendet, um beschwerdebasierte Lösungsanforderungen zu erfüllen (siehe ResolveServicePartitionAsync(Uri, ResolvedServicePartition)). Anwendungen, die sich sowohl für Benachrichtigungen registrieren als auch beschwerdebasierte Lösung auf demselben Client instance müssen normalerweise nur null für das Argument während der ResolvedServicePartition Lösung übergeben. Dadurch werden immer die Endpunkte im Clientcache zurückgegeben, die durch die neueste Benachrichtigung aktualisiert wurden. Der Benachrichtigungsmechanismus selbst hält den Clientcache auf dem neuesten Stand, wenn sich Die Dienstendpunkte ändern. Es ist nicht erforderlich, von einer ServiceNotification in eine ResolvedServicePartition zu konvertieren, um den Clientcache zu aktualisieren.

Gilt für: