你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ServiceBusRuleManager.CreateRuleAsync 方法

定义

命名空间:

Azure.Messaging.ServiceBus

程序集:

Azure.Messaging.ServiceBus.dll

包:

Azure.Messaging.ServiceBus v7.17.5

重载

CreateRuleAsync(CreateRuleOptions, CancellationToken)	将规则添加到当前订阅，以筛选从主题到达订阅的消息。
CreateRuleAsync(String, RuleFilter, CancellationToken)	将规则添加到当前订阅，以筛选从主题到达订阅的消息。

CreateRuleAsync(CreateRuleOptions, CancellationToken)

Source:

ServiceBusRuleManager.cs

将规则添加到当前订阅，以筛选从主题到达订阅的消息。

public virtual System.Threading.Tasks.Task CreateRuleAsync (Azure.Messaging.ServiceBus.Administration.CreateRuleOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateRuleAsync : Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateRuleAsync : Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateRuleAsync (options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

options

CreateRuleOptions

要添加的规则的选项。

cancellationToken

CancellationToken

一个可选 CancellationToken 实例，用于向请求发出取消操作的信号。

返回

Task

表示异步添加规则操作的任务实例。

例外

ServiceBusException

• 订阅下存在同名的规则。 在这种情况下， Reason 将设置为 MessagingEntityAlreadyExists 。
• 操作超时。在这种情况下， Reason 将设置为 ServiceTimeout 。
• 实体的指定大小不受支持，或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。 在这种情况下，失败原因将设置为 QuotaExceeded 。
• 服务器繁忙。 在重试操作之前，应等待。 在这种情况下，失败原因将设置为 ServiceBusy 。
• 发生内部错误或意外异常。 在这种情况下，失败原因将设置为 GeneralError 。

注解

可以向订阅添加规则，以确定主题中的哪些消息应到达订阅。 创建订阅时，始终添加名为 DefaultRuleName 的默认TrueRuleFilter规则。 可以将具有不同名称的多个规则添加到同一订阅。 多个筛选器使用逻辑 OR 条件相互组合。 即，如果任何筛选器成功，则消息将传递到订阅。

CreateRuleAsync(String, RuleFilter, CancellationToken)

Source:

ServiceBusRuleManager.cs

将规则添加到当前订阅，以筛选从主题到达订阅的消息。

public virtual System.Threading.Tasks.Task CreateRuleAsync (string ruleName, Azure.Messaging.ServiceBus.Administration.RuleFilter filter, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateRuleAsync : string * Azure.Messaging.ServiceBus.Administration.RuleFilter * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateRuleAsync : string * Azure.Messaging.ServiceBus.Administration.RuleFilter * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateRuleAsync (ruleName As String, filter As RuleFilter, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

ruleName

String

规则名称

filter

RuleFilter

将与之匹配消息的筛选表达式。

cancellationToken

CancellationToken

一个可选 CancellationToken 实例，用于向请求发出取消操作的信号。

返回

Task

表示异步添加规则操作的任务实例。

例外

ServiceBusException

• 订阅下存在同名的规则。 在这种情况下， Reason 将设置为 MessagingEntityAlreadyExists 。
• 操作超时。在这种情况下， Reason 将设置为 ServiceTimeout 。
• 实体的指定大小不受支持，或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。 在这种情况下，失败原因将设置为 QuotaExceeded 。
• 服务器繁忙。 在重试操作之前，应等待。 在这种情况下，失败原因将设置为 ServiceBusy 。
• 发生内部错误或意外异常。 在这种情况下，失败原因将设置为 GeneralError 。

注解

可以向订阅添加规则，以确定主题中的哪些消息应到达订阅。 创建订阅时，始终添加名为 DefaultRuleName 的默认TrueRuleFilter规则。 可以将具有不同名称的多个规则添加到同一订阅。 多个筛选器使用逻辑 OR 条件相互组合。 即，如果任何筛选器成功，则消息将传递到订阅。