ActivityHandler.OnConversationUpdateActivityAsync Méthode
Définition
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 à l’ajout d’un utilisateur en le saluant. 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’elle ne réponde qu’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.TaskProtected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As TaskParamètres
- turnContext
- ITurnContext<IConversationUpdateActivity>
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 pour s’exécuter.
Remarques
Lorsque la OnTurnAsync(ITurnContext, CancellationToken) méthode reçoit une activité de mise à jour de conversation, elle appelle cette méthode. Si l’activité de mise à jour de conversation indique que des membres autres que le bot ont rejoint la conversation, elle appelle OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Si l’activité de mise à jour de conversation indique que des membres autres 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. Ajoutez la logique à appliquer avant que le membre a ajouté ou supprimé la logique avant l’appel à la méthode de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) de base. Ajoutez une logique à appliquer après l’ajout ou la suppression de la logique du membre après l’appel à la méthode de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) de base.