ActivityHandler.OnConversationUpdateActivityAsync 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é de mise à jour de conversation est reçue du canal lorsque le comportement de base de OnTurnAsync(ITurnContext, CancellationToken) est utilisé. Les activités de mise à jour de conversation sont utiles lorsqu’il s’agit de répondre aux utilisateurs ajoutés ou supprimés de la conversation. Par exemple, un bot peut répondre à un utilisateur ajouté en saluant l’utilisateur. Par défaut, cette méthode appelle OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) si des utilisateurs ont été ajoutés ou OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) si des utilisateurs ont été supprimés. La méthode vérifie l’ID de membre afin qu’il réponde uniquement aux mises à jour concernant les membres autres que le bot lui-même.

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

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

Protected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As Task

Paramètres

turnContext: ITurnContext<IConversationUpdateActivity>

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é de mise à jour de conversation, elle appelle cette méthode. Si l’activité de mise à jour de la conversation indique que d’autres membres que le bot ont rejoint la conversation, elle appelle OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Si l’activité de mise à jour de la conversation indique que d’autres membres que le bot ont quitté la conversation, elle appelle OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

Dans une classe dérivée, remplacez cette méthode pour ajouter une logique qui s’applique à toutes les activités de mise à jour de conversation. Ajouter la logique à appliquer avant que le membre n’ajoute ou retire la logique avant l’appel à la méthode de la classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) de base. Ajouter de la logique à appliquer après que le membre ait ajouté ou retiré la logique après l’appel à la méthode de la classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) de base.

S’applique à