Delen via


ActivityHandler.OnCommandActivityAsync Methode

Definitie

Wordt aangeroepen wanneer een opdrachtactiviteit wordt ontvangen wanneer het basisgedrag van OnTurnAsync(ITurnContext, CancellationToken) wordt gebruikt. Opdrachten zijn aanvragen om een actie uit te voeren en ontvangers reageren doorgaans met een of meer commandResult-activiteiten. Van ontvangers wordt ook verwacht dat ze niet-ondersteunde opdrachtactiviteiten 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.Task
Protected Overridable Function OnCommandActivityAsync (turnContext As ITurnContext(Of ICommandActivity), cancellationToken As CancellationToken) As Task

Parameters

turnContext
ITurnContext<ICommandActivity>

Een contextobject met een sterk type voor deze beurt.

cancellationToken
CancellationToken

Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om een 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 opdrachtactiviteit ontvangt, wordt deze methode aangeroepen.

In een afgeleide klasse overschrijft u deze methode om logica toe te voegen die van toepassing is op alle comand-activiteiten. Voeg logica toe die moet worden toegepast vóór de specifieke opdrachtafhandelingslogica vóór de aanroep van de basisklassemethode OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) . Voeg logica toe die moet worden toegepast na de specifieke logica voor opdrachtafhandeling na de aanroep van de basisklassemethode OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) .

Opdrachtactiviteiten communiceren programmatische informatie van een client of kanaal naar een bot. De betekenis van een opdrachtactiviteit wordt gedefinieerd door de Name eigenschap, die zinvol is binnen het bereik van een kanaal.

Van toepassing op

Zie ook