Partager via


ActivityHandler.OnCommandActivityAsync Méthode

Définition

Appelé lorsqu’une activité de commande est reçue lorsque le comportement de base de OnTurnAsync(ITurnContext, CancellationToken) est utilisé. Les commandes sont des demandes d’exécution d’une action et les récepteurs répondent généralement avec une ou plusieurs activités commandResult. Les récepteurs sont également censés rejeter explicitement les activités de commande non prises en charge.

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

Paramètres

turnContext
ITurnContext<ICommandActivity>

Objet de contexte fortement typé pour ce tour.

cancellationToken
CancellationToken

Jeton d'annulation qui peut être utilisé par d'autres objets ou threads pour être informés de l'annulation.

Retours

Tâche qui représente le travail mis en file d’attente à exécuter.

Remarques

Quand la OnTurnAsync(ITurnContext, CancellationToken) méthode reçoit une activité de commande, elle appelle cette méthode.

Dans une classe dérivée, remplacez cette méthode pour ajouter une logique qui s’applique à toutes les activités comand. Ajoutez la logique à appliquer avant la logique de gestion de commande spécifique avant l’appel à la méthode de classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) de base. Ajoutez la logique à appliquer après la logique de gestion de commande spécifique après l’appel à la méthode de classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) de base.

Les activités de commande communiquent des informations programmatiques d’un client ou d’un canal à un bot. La signification d’une activité de commande est définie par la Name propriété , qui est significative dans l’étendue d’un canal.

S’applique à

Voir aussi