ServiceBusRuleManager.CreateRuleAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Hiermee voegt u een regel toe aan het huidige abonnement om de berichten van het onderwerp naar het abonnement te filteren. |
| CreateRuleAsync(String, RuleFilter, CancellationToken) |
Hiermee voegt u een regel toe aan het huidige abonnement om de berichten van het onderwerp naar het abonnement te filteren. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
Hiermee voegt u een regel toe aan het huidige abonnement om de berichten van het onderwerp naar het abonnement te filteren.
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 TaskParameters
- options
- CreateRuleOptions
De opties voor de regel die moet worden toegevoegd.
- cancellationToken
- CancellationToken
Een optioneel CancellationToken exemplaar om aan te geven dat de aanvraag de bewerking moet annuleren.
Retouren
Een taakexemplaren die de asynchrone bewerking voor het toevoegen van regels vertegenwoordigt.
Uitzonderingen
- Er bestaat een regel met dezelfde naam onder het abonnement. De Reason wordt in dit geval ingesteld op MessagingEntityAlreadyExists .
- Er is een time-out opgetreden voor de bewerking. De Reason wordt in dit geval ingesteld op ServiceTimeout .
- De opgegeven grootte van de entiteit wordt niet ondersteund of het maximaal toegestane quotum is bereikt. U moet een van de ondersteunde groottewaarden opgeven, bestaande entiteiten verwijderen of de quotumgrootte verhogen. De reden van de fout wordt in dit geval ingesteld op QuotaExceeded .
- De server is bezet. U moet wachten voordat u de bewerking opnieuw probeert uit te voeren. De reden van de fout wordt in dit geval ingesteld op ServiceBusy .
- Er treedt een interne fout of onverwachte uitzondering op. De reden van de fout wordt in dit geval ingesteld op GeneralError .
Opmerkingen
U kunt regels toevoegen aan het abonnement die bepalen welke berichten van het onderwerp het abonnement moeten bereiken. Er wordt altijd een standaardregel TrueRuleFilter met de naam DefaultRuleName toegevoegd tijdens het maken van het abonnement. U kunt meerdere regels met afzonderlijke namen toevoegen aan hetzelfde abonnement. Meerdere filters worden met elkaar gecombineerd met behulp van de logische OF-voorwaarde. Dat wil zeggen, als een filter slaagt, wordt het bericht doorgegeven aan het abonnement.
Van toepassing op
CreateRuleAsync(String, RuleFilter, CancellationToken)
Hiermee voegt u een regel toe aan het huidige abonnement om de berichten van het onderwerp naar het abonnement te filteren.
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 TaskParameters
- ruleName
- String
Naam van de regel
- filter
- RuleFilter
De filterexpressie waarmee berichten worden vergeleken.
- cancellationToken
- CancellationToken
Een optioneel CancellationToken exemplaar om aan te geven dat de aanvraag de bewerking moet annuleren.
Retouren
Een taakexemplaren die de asynchrone bewerking voor het toevoegen van regels vertegenwoordigt.
Uitzonderingen
- Er bestaat een regel met dezelfde naam onder het abonnement. De Reason wordt in dit geval ingesteld op MessagingEntityAlreadyExists .
- Er is een time-out opgetreden voor de bewerking. De Reason wordt in dit geval ingesteld op ServiceTimeout .
- De opgegeven grootte van de entiteit wordt niet ondersteund of het maximaal toegestane quotum is bereikt. U moet een van de ondersteunde groottewaarden opgeven, bestaande entiteiten verwijderen of de quotumgrootte verhogen. De reden van de fout wordt in dit geval ingesteld op QuotaExceeded .
- De server is bezet. U moet wachten voordat u de bewerking opnieuw probeert uit te voeren. De reden van de fout wordt in dit geval ingesteld op ServiceBusy .
- Er treedt een interne fout of onverwachte uitzondering op. De reden van de fout wordt in dit geval ingesteld op GeneralError .
Opmerkingen
U kunt regels toevoegen aan het abonnement die bepalen welke berichten van het onderwerp het abonnement moeten bereiken. Er wordt altijd een standaardregel TrueRuleFilter met de naam DefaultRuleName toegevoegd tijdens het maken van het abonnement. U kunt meerdere regels met afzonderlijke namen toevoegen aan hetzelfde abonnement. Meerdere filters worden met elkaar gecombineerd met behulp van de logische OF-voorwaarde. Dat wil zeggen, als een filter slaagt, wordt het bericht doorgegeven aan het abonnement.