ActivityHandler.OnCommandActivityAsync 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.
Wordt aangeroepen wanneer een commando-activiteit wordt ontvangen wanneer het basisgedrag van OnTurnAsync(ITurnContext, CancellationToken) wordt gebruikt. Commando's zijn verzoeken om een actie uit te voeren en ontvangers reageren doorgaans met een of meer commandResult-activiteiten. Ontvangers worden ook verwacht dat ze niet-ondersteunde commando-activiteiten expliciet afwijzen.
protected virtual System.Threading.Tasks.Task OnCommandActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandActivity> turnContext, System.Threading.CancellationToken cancellationToken);abstract member OnCommandActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnCommandActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskProtected Overridable Function OnCommandActivityAsync (turnContext As ITurnContext(Of ICommandActivity), cancellationToken As CancellationToken) As TaskParameters
- turnContext
- ITurnContext<ICommandActivity>
Een sterk getypeerd contextobject voor deze beurt.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om kennisgeving van annulering te ontvangen.
Retouren
Een taak die het werk vertegenwoordigt dat in de wachtrij staat om uit te voeren.
Opmerkingen
Wanneer de OnTurnAsync(ITurnContext, CancellationToken) methode een commando-activiteit ontvangt, roept hij deze methode aan.
In een afgeleide klasse overschrijf je deze methode om logica toe te voegen die van toepassing is op alle commando-activiteiten. Voeg logica toe die wordt toegepast vóór de specifieke commandobehandelingslogica vóór de aanroep van de basisklassemethode OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) . Voeg logica toe die toegepast wordt na de specifieke commando-afhandelingslogica na de aanroep van de basisklasse-methode OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) .
Commando-activiteiten communiceren programmatische informatie van een client of kanaal naar een bot. De betekenis van een commando-activiteit wordt bepaald door de Name eigenschap die betekenisvol is binnen de scope van een kanaal.