你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
FabricClient.ServiceManagementClient.RegisterServiceNotificationFilterAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
RegisterServiceNotificationFilterAsync(ServiceNotificationFilterDescription, TimeSpan, CancellationToken)
注册 ServiceNotificationFilterDescription。 还采用超时间隔,这是系统在返回 TimeoutException 操作之前允许此操作继续的最长时间,以及操作观察到的取消标记。
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)
参数
- description
- ServiceNotificationFilterDescription
确定应通过 ServiceNotificationFilterMatched 事件将哪些服务终结点更改事件传递到此客户端的说明。
- timeout
- TimeSpan
引发之前 TimeoutException 处理请求所允许的最长时间。
- cancellationToken
- CancellationToken
保留供将来使用。
返回
表示 Task 异步操作的 。 任务结果是一个对应于已注册 ServiceNotificationFilterDescription 的 ID,可用于通过 UnregisterServiceNotificationFilterAsync(Int64)取消注册同一筛选器。
例外
如果 description
为 null。
注解
客户端中有一个由通知更新的服务终结点的缓存,此缓存用于满足基于投诉的解决请求, (查看 ResolveServicePartitionAsync(Uri, ResolvedServicePartition)) 。 在同一客户端实例上注册通知并使用基于投诉的解决方案的应用程序通常只需在解析过程中为 ResolvedServicePartition 参数传递 null。 这将始终返回客户端缓存中由最新通知更新的终结点。 通知机制本身会在服务终结点更改时保持客户端缓存更新,无需为了刷新客户端缓存而从 ServiceNotification 转换为 ResolvedServicePartition 。
适用于
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)
参数
- description
- ServiceNotificationFilterDescription
确定应通过 ServiceNotificationFilterMatched 事件将哪些服务终结点更改事件传递到此客户端的说明。
返回
表示 Task 异步操作的 。 任务结果是一个对应于已注册 ServiceNotificationFilterDescription 的 ID,可用于通过 UnregisterServiceNotificationFilterAsync(Int64)取消注册同一筛选器。
例外
如果 description
为 null。
注解
默认超时为一分钟,系统将允许此操作在返回 TimeoutException之前继续。
客户端中有一个由通知更新的服务终结点的缓存,此缓存用于满足基于投诉的解决请求, (查看 ResolveServicePartitionAsync(Uri, ResolvedServicePartition)) 。 在同一客户端实例上注册通知并使用基于投诉的解决方案的应用程序通常只需在解析过程中为 ResolvedServicePartition 参数传递 null。 这将始终返回客户端缓存中由最新通知更新的终结点。 通知机制本身会在服务终结点更改时保持客户端缓存更新,无需为了刷新客户端缓存而从 ServiceNotification 转换为 ResolvedServicePartition 。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈