ServiceBusRuleManager.CreateRuleAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Fügt dem aktuellen Abonnement eine Regel hinzu, um die Nachrichten zu filtern, die vom Thema in das Abonnement gelangen. |
| CreateRuleAsync(String, RuleFilter, CancellationToken) |
Fügt dem aktuellen Abonnement eine Regel hinzu, um die Nachrichten zu filtern, die vom Thema in das Abonnement gelangen. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
- Quelle:
- ServiceBusRuleManager.cs
- Quelle:
- ServiceBusRuleManager.cs
Fügt dem aktuellen Abonnement eine Regel hinzu, um die Nachrichten zu filtern, die vom Thema in das Abonnement gelangen.
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 TaskParameter
- options
- CreateRuleOptions
Die Optionen für die hinzuzufügende Regel.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um die Anforderung zum Abbrechen des Vorgangs zu signalisieren.
Gibt zurück
Eine Aufgabe instance, die den asynchronen Regelvorgang zum Hinzufügen von Regeln darstellt.
Ausnahmen
- Unter dem Abonnement ist eine Regel mit demselben Namen vorhanden. In Reason diesem Fall wird auf MessagingEntityAlreadyExists festgelegt.
- Für den Vorgang wurde ein Timeout ausgeführt. In Reason diesem Fall wird auf ServiceTimeout festgelegt.
- Entweder wird die angegebene Größe der Entität nicht unterstützt, oder das maximal zulässige Kontingent wurde erreicht. Sie müssen einen der unterstützten Größenwerte angeben, vorhandene Entitäten löschen oder Ihre Kontingentgröße erhöhen. Der Fehlergrund wird in diesem Fall auf QuotaExceeded festgelegt.
- Der Server ist ausgelastet. Sie sollten warten, bevor Sie den Vorgang wiederholen. Der Fehlergrund wird in diesem Fall auf ServiceBusy festgelegt.
- Es tritt ein interner Fehler oder eine unerwartete Ausnahme auf. Der Fehlergrund wird in diesem Fall auf GeneralError festgelegt.
Hinweise
Sie können dem Abonnement Regeln hinzufügen, die entscheiden, welche Nachrichten aus dem Thema das Abonnement erreichen sollen. Beim Erstellen des Abonnements wird immer eine Standardregel TrueRuleFilter mit dem Namen DefaultRuleName hinzugefügt. Sie können demselben Abonnement mehrere Regeln mit unterschiedlichen Namen hinzufügen. Mehrere Filter werden mithilfe der logischen OR-Bedingung miteinander kombiniert. D. h., wenn ein Filter erfolgreich ist, wird die Nachricht an das Abonnement übergeben.
Gilt für:
CreateRuleAsync(String, RuleFilter, CancellationToken)
- Quelle:
- ServiceBusRuleManager.cs
- Quelle:
- ServiceBusRuleManager.cs
Fügt dem aktuellen Abonnement eine Regel hinzu, um die Nachrichten zu filtern, die vom Thema in das Abonnement gelangen.
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 TaskParameter
- ruleName
- String
Name der Regel
- filter
- RuleFilter
Der Filterausdruck, mit dem Nachrichten abgeglichen werden.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um die Anforderung zum Abbrechen des Vorgangs zu signalisieren.
Gibt zurück
Eine Aufgabe instance, die den asynchronen Regelvorgang zum Hinzufügen von Regeln darstellt.
Ausnahmen
- Unter dem Abonnement ist eine Regel mit demselben Namen vorhanden. In Reason diesem Fall wird auf MessagingEntityAlreadyExists festgelegt.
- Für den Vorgang wurde ein Timeout ausgeführt. In Reason diesem Fall wird auf ServiceTimeout festgelegt.
- Entweder wird die angegebene Größe der Entität nicht unterstützt, oder das maximal zulässige Kontingent wurde erreicht. Sie müssen einen der unterstützten Größenwerte angeben, vorhandene Entitäten löschen oder Ihre Kontingentgröße erhöhen. Der Fehlergrund wird in diesem Fall auf QuotaExceeded festgelegt.
- Der Server ist ausgelastet. Sie sollten warten, bevor Sie den Vorgang wiederholen. Der Fehlergrund wird in diesem Fall auf ServiceBusy festgelegt.
- Es tritt ein interner Fehler oder eine unerwartete Ausnahme auf. Der Fehlergrund wird in diesem Fall auf GeneralError festgelegt.
Hinweise
Sie können dem Abonnement Regeln hinzufügen, die entscheiden, welche Nachrichten aus dem Thema das Abonnement erreichen sollen. Beim Erstellen des Abonnements wird immer eine Standardregel TrueRuleFilter mit dem Namen DefaultRuleName hinzugefügt. Sie können demselben Abonnement mehrere Regeln mit unterschiedlichen Namen hinzufügen. Mehrere Filter werden mithilfe der logischen OR-Bedingung miteinander kombiniert. D. h., wenn ein Filter erfolgreich ist, wird die Nachricht an das Abonnement übergeben.
Gilt für:
Azure SDK for .NET