ServiceBusRuleManager.CreateRuleAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Aggiunge una regola alla sottoscrizione corrente per filtrare i messaggi che raggiungono l'argomento alla sottoscrizione. |
CreateRuleAsync(String, RuleFilter, CancellationToken) |
Aggiunge una regola alla sottoscrizione corrente per filtrare i messaggi che raggiungono l'argomento alla sottoscrizione. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
Aggiunge una regola alla sottoscrizione corrente per filtrare i messaggi che raggiungono l'argomento alla sottoscrizione.
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
Parametri
- options
- CreateRuleOptions
Opzioni per la regola da aggiungere.
- cancellationToken
- CancellationToken
Istanza facoltativa CancellationToken per segnalare la richiesta di annullare l'operazione.
Restituisce
Istanza dell'attività che rappresenta l'operazione di aggiunta asincrona della regola.
Eccezioni
- Esiste una regola con lo stesso nome nella sottoscrizione. L'oggetto Reason verrà impostato su MessagingEntityAlreadyExists in questo caso.
- Timeout dell'operazione. L'oggetto Reason verrà impostato su ServiceTimeout in questo caso.
- Le dimensioni specificate dell'entità non sono supportate o la quota massima consentita è stata raggiunta. È necessario specificare uno dei valori delle dimensioni supportate, eliminare le entità esistenti o aumentare le dimensioni della quota. Il motivo dell'errore verrà impostato su QuotaExceeded in questo caso.
- Il server è occupato. È necessario attendere prima di ripetere l'operazione. Il motivo dell'errore verrà impostato su ServiceBusy in questo caso.
- Si verifica un errore interno o un'eccezione imprevista. Il motivo dell'errore verrà impostato su GeneralError in questo caso.
Commenti
È possibile aggiungere regole alla sottoscrizione che determina quali messaggi dall'argomento devono raggiungere la sottoscrizione. Viene sempre aggiunta una regola predefinita denominata TrueRuleFilterDefaultRuleName durante la creazione della sottoscrizione. È possibile aggiungere più regole con nomi distinti alla stessa sottoscrizione. Più filtri si combinano tra loro usando la condizione OR logica. Ad esempio, se un filtro ha esito positivo, il messaggio viene passato alla sottoscrizione.
Si applica a
CreateRuleAsync(String, RuleFilter, CancellationToken)
Aggiunge una regola alla sottoscrizione corrente per filtrare i messaggi che raggiungono l'argomento alla sottoscrizione.
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
Parametri
- ruleName
- String
Nome della regola
- filter
- RuleFilter
Espressione di filtro in base alla quale verranno confrontati i messaggi.
- cancellationToken
- CancellationToken
Istanza facoltativa CancellationToken per segnalare la richiesta di annullare l'operazione.
Restituisce
Istanza dell'attività che rappresenta l'operazione di aggiunta asincrona della regola.
Eccezioni
- Esiste una regola con lo stesso nome nella sottoscrizione. L'oggetto Reason verrà impostato su MessagingEntityAlreadyExists in questo caso.
- Timeout dell'operazione. L'oggetto Reason verrà impostato su ServiceTimeout in questo caso.
- Le dimensioni specificate dell'entità non sono supportate o la quota massima consentita è stata raggiunta. È necessario specificare uno dei valori delle dimensioni supportate, eliminare le entità esistenti o aumentare le dimensioni della quota. Il motivo dell'errore verrà impostato su QuotaExceeded in questo caso.
- Il server è occupato. È necessario attendere prima di ripetere l'operazione. Il motivo dell'errore verrà impostato su ServiceBusy in questo caso.
- Si verifica un errore interno o un'eccezione imprevista. Il motivo dell'errore verrà impostato su GeneralError in questo caso.
Commenti
È possibile aggiungere regole alla sottoscrizione che determina quali messaggi dall'argomento devono raggiungere la sottoscrizione. Viene sempre aggiunta una regola predefinita denominata TrueRuleFilterDefaultRuleName durante la creazione della sottoscrizione. È possibile aggiungere più regole con nomi distinti alla stessa sottoscrizione. Più filtri si combinano tra loro usando la condizione OR logica. Ad esempio, se un filtro ha esito positivo, il messaggio viene passato alla sottoscrizione.