ActivityHandler.OnConversationUpdateActivityAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается при получении действия обновления диалога из канала при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken) . Действия по обновлению беседы полезны при реагировании на добавление пользователей в беседу или удаление из нее. Например, бот может ответить на добавление пользователя приветствием пользователя. По умолчанию этот метод вызывается OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) при добавлении пользователей или OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) удалении пользователей. Метод проверяет идентификатор элемента, чтобы он реагировал только на обновления, касающиеся членов, отличных от самого бота.
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 TaskПараметры
- turnContext
- ITurnContext<IConversationUpdateActivity>
Строго типизированный объект контекста для этого шага.
- cancellationToken
- CancellationToken
Токен отмены, который может использоваться другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Задача, представляющая работу, поставленную в очередь для выполнения.
Комментарии
OnTurnAsync(ITurnContext, CancellationToken) Когда метод получает действие обновления диалога, он вызывает этот метод. Если действие обновления диалога указывает, что к беседе присоединились участники, отличные от бота, оно вызывает .OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) Если действие обновления диалога указывает, что участники, отличные от бота, покинули беседу, оно вызывает .OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)
В производном классе переопределите этот метод, чтобы добавить логику, которая применяется ко всем действиям обновления диалога. Добавьте логику, применяемую перед добавлением или удалением логики члена перед вызовом метода базового класса OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) . Добавьте логику, применяемую после добавления или удаления логики члена после вызова метода базового класса OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) .