ActivityHandler.OnConversationUpdateActivityAsync Método

Referência

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 saudando 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 esse turno.

cancellationToken: CancellationToken

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

Retornos

Task

Uma tarefa que representa o trabalho enfileirado para execução.

Comentários

Quando o OnTurnAsync(ITurnContext, CancellationToken) método recebe uma atividade de atualização de conversa, ele chama esse método. Se a atividade de atualização de conversa indicar que membros diferentes do bot ingressaram na conversa, ele chamará OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Se a atividade de atualização da conversa indicar que membros diferentes do bot deixaram a conversa, ele chamará 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. Adicione lógica a ser aplicada antes que o membro adicione ou remova a lógica antes da chamada ao método de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Adicione lógica a ser aplicada depois que o membro adicionou ou removeu a lógica após a chamada ao método de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.

Aplica-se a

Compartilhar via