ActivityHandler.OnEventActivityAsync Méthode

Définition

Espace de noms:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Paquet:: Microsoft.Bot.Builder v4.22.7

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Appelé lorsqu’une activité d’événement est reçue du connecteur lorsque le comportement de base de OnTurnAsync(ITurnContext, CancellationToken) est utilisé. Les activités d’événement peuvent être utilisées pour communiquer de nombreuses choses différentes. Par défaut, cette méthode appellera OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) si le nom de l’activité est tokens/response ou OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) non. Un tokens/response événement peut être déclenché par un OAuthCard.

protected virtual System.Threading.Tasks.Task OnEventActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> turnContext, System.Threading.CancellationToken cancellationToken);

abstract member OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Protected Overridable Function OnEventActivityAsync (turnContext As ITurnContext(Of IEventActivity), cancellationToken As CancellationToken) As Task

Paramètres

turnContext: ITurnContext<IEventActivity>

Un objet contextuel fortement typé pour ce tour.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task

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

Remarques

Lorsque la méthode OnTurnAsync(ITurnContext, CancellationToken) reçoit une activité d’événement, elle appelle cette méthode. Si l’événement Name est « tokens/réponse », il appelle OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); sinon, il appelle OnEventAsync(ITurnContext<IEventActivity>, CancellationToken).

Dans une classe dérivée, substituez cette méthode pour ajouter une logique qui s’applique à toutes les activités d’événement. Ajouter la logique à appliquer avant la logique spécifique de gestion des événements avant l’appel à la méthode de la classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) de base. Ajoutez la logique à appliquer après la logique spécifique de gestion des événements après l’appel à la méthode de la classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) de base.

Les activités d’événement communiquent des informations programmatiques d’un client ou d’un canal à un bot. La signification d’une activité d’événement est définie par la propriété Name, qui est significative dans l’étendue d’un canal. Un événement « tokens/response » peut être déclenché par un OAuthCard ou une invite OAuth.

S’applique à