ServiceBusRuleManager.CreateRuleAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Agrega una regla a la suscripción actual para filtrar los mensajes que llegan del tema a la suscripción. |
| CreateRuleAsync(String, RuleFilter, CancellationToken) |
Agrega una regla a la suscripción actual para filtrar los mensajes que llegan del tema a la suscripción. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
- Source:
- ServiceBusRuleManager.cs
- Source:
- ServiceBusRuleManager.cs
Agrega una regla a la suscripción actual para filtrar los mensajes que llegan del tema a la suscripción.
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.TaskPublic Overridable Function CreateRuleAsync (options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- options
- CreateRuleOptions
Las opciones de la regla que se van a agregar.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
Una instancia de tarea que representa la operación de agregar regla asincrónica.
Excepciones
- Existe una regla con el mismo nombre en la suscripción. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Puede agregar reglas a la suscripción que decida qué mensajes del tema deben llegar a la suscripción. Siempre se agrega una regla predeterminada TrueRuleFilter denominada DefaultRuleName mientras se crea la suscripción. Puede agregar varias reglas con nombres distintos a la misma suscripción. Varios filtros se combinan entre sí mediante la condición OR lógica. Es decir, si algún filtro se realiza correctamente, el mensaje se pasa a la suscripción.
Se aplica a
CreateRuleAsync(String, RuleFilter, CancellationToken)
- Source:
- ServiceBusRuleManager.cs
- Source:
- ServiceBusRuleManager.cs
Agrega una regla a la suscripción actual para filtrar los mensajes que llegan del tema a la suscripción.
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.TaskPublic Overridable Function CreateRuleAsync (ruleName As String, filter As RuleFilter, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- ruleName
- String
Nombre de la regla.
- filter
- RuleFilter
Expresión de filtro con la que se buscarán coincidencias con los mensajes.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
Una instancia de tarea que representa la operación de agregar regla asincrónica.
Excepciones
- Existe una regla con el mismo nombre en la suscripción. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Puede agregar reglas a la suscripción que decida qué mensajes del tema deben llegar a la suscripción. Siempre se agrega una regla predeterminada TrueRuleFilter denominada DefaultRuleName mientras se crea la suscripción. Puede agregar varias reglas con nombres distintos a la misma suscripción. Varios filtros se combinan entre sí mediante la condición OR lógica. Es decir, si algún filtro se realiza correctamente, el mensaje se pasa a la suscripción.
Se aplica a
Azure SDK for .NET