ActivityHandler.OnConversationUpdateActivityAsync Método

Definição

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Pacote:: Microsoft.Bot.Builder v4.22.7

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Invocado quando uma atividade de atualização de conversa é recebida do canal quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é usado. As atividades de atualização de conversa são úteis quando se trata de responder aos usuários que estão sendo adicionados ou removidos da conversa. Por exemplo, um bot pode responder a um usuário que está sendo adicionado cumprimentando o usuário. Por padrão, esse método chamará OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se algum usuário tiver sido adicionado ou OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se algum usuário tiver sido removido. O método verifica a ID do membro para que ele responda apenas às atualizações relacionadas a membros diferentes do próprio bot.

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

Parâmetros

turnContext: ITurnContext<IConversationUpdateActivity>

Um objeto de contexto fortemente tipado para este turno.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Retornos

Task

Uma tarefa que representa o trabalho enfileirado a ser executado.

Comentários

Quando o método OnTurnAsync(ITurnContext, CancellationToken) recebe uma atividade de atualização de conversa, ele chama esse método. Se a atividade de atualização da conversa indicar que membros além do bot participaram da conversa, ela chama OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Se a atividade de atualização da conversa indicar que membros além do bot saíram da conversa, ela chama OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

Em uma classe derivada, substitua esse método para adicionar lógica que se aplica a todas as atividades de atualização de conversa. Adicionar lógica para aplicar antes do membro adicionar ou remover lógica antes da chamada para o método de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Adicione lógica para aplicar após o membro adicionar ou remover lógica após a chamada para o método de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.

Aplica-se a