ServiceBusRuleManager.CreateRuleAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Lägger till en regel i den aktuella prenumerationen för att filtrera meddelanden som når från ämne till prenumeration. |
| CreateRuleAsync(String, RuleFilter, CancellationToken) |
Lägger till en regel i den aktuella prenumerationen för att filtrera meddelanden som når från ämne till prenumeration. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
Lägger till en regel i den aktuella prenumerationen för att filtrera meddelanden som når från ämne till prenumeration.
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 TaskParametrar
- options
- CreateRuleOptions
Alternativen för regeln som ska läggas till.
- cancellationToken
- CancellationToken
En valfri CancellationToken instans för att signalera begäran om att avbryta åtgärden.
Returer
En uppgiftsinstans som representerar den asynkrona åtgärden lägg till regel.
Undantag
- Det finns en regel med samma namn under prenumerationen. Reason anges till MessagingEntityAlreadyExists i det här fallet.
- Tidsgränsen för åtgärden överst. Reason anges till ServiceTimeout i det här fallet.
- Antingen stöds inte den angivna storleken på entiteten eller så har den maximala tillåtna kvoten uppnåtts. Du måste ange ett av de storleksvärden som stöds, ta bort befintliga entiteter eller öka kvotstorleken. Felorsaken anges till QuotaExceeded i det här fallet.
- Servern är upptagen. Du bör vänta innan du försöker utföra åtgärden igen. Felorsaken anges till ServiceBusy i det här fallet.
- Ett internt fel eller ett oväntat undantag inträffar. Felorsaken anges till GeneralError i det här fallet.
Kommentarer
Du kan lägga till regler i prenumerationen som bestämmer vilka meddelanden från ämnet som ska nå prenumerationen. En standardregel TrueRuleFilter med namnet DefaultRuleName läggs alltid till när prenumerationen skapas. Du kan lägga till flera regler med distinkta namn i samma prenumeration. Flera filter kombineras med varandra med hjälp av logiska ELLER-villkor. Om ett filter lyckas skickas meddelandet till prenumerationen.
Gäller för
CreateRuleAsync(String, RuleFilter, CancellationToken)
Lägger till en regel i den aktuella prenumerationen för att filtrera meddelanden som når från ämne till prenumeration.
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 TaskParametrar
- ruleName
- String
Namnet på regeln
- filter
- RuleFilter
Filteruttrycket som meddelandena ska matchas mot.
- cancellationToken
- CancellationToken
En valfri CancellationToken instans för att signalera begäran om att avbryta åtgärden.
Returer
En uppgiftsinstans som representerar den asynkrona åtgärden lägg till regel.
Undantag
- Det finns en regel med samma namn under prenumerationen. Reason anges till MessagingEntityAlreadyExists i det här fallet.
- Tidsgränsen för åtgärden överst. Reason anges till ServiceTimeout i det här fallet.
- Antingen stöds inte den angivna storleken på entiteten eller så har den maximala tillåtna kvoten uppnåtts. Du måste ange ett av de storleksvärden som stöds, ta bort befintliga entiteter eller öka kvotstorleken. Felorsaken anges till QuotaExceeded i det här fallet.
- Servern är upptagen. Du bör vänta innan du försöker utföra åtgärden igen. Felorsaken anges till ServiceBusy i det här fallet.
- Ett internt fel eller ett oväntat undantag inträffar. Felorsaken anges till GeneralError i det här fallet.
Kommentarer
Du kan lägga till regler i prenumerationen som bestämmer vilka meddelanden från ämnet som ska nå prenumerationen. En standardregel TrueRuleFilter med namnet DefaultRuleName läggs alltid till när prenumerationen skapas. Du kan lägga till flera regler med distinkta namn i samma prenumeration. Flera filter kombineras med varandra med hjälp av logiska ELLER-villkor. Om ett filter lyckas skickas meddelandet till prenumerationen.