ActivityHandler.OnConversationUpdateActivityAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Invocada quando uma atividade de atualização de conversação é recebida do canal quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é utilizado. As atividades de atualização de conversação são úteis quando se trata de responder a utilizadores que estão a ser adicionados ou removidos da conversação. Por exemplo, um bot pode responder a um utilizador que está a ser adicionado ao cumprimentar o utilizador. Por predefinição, este método irá chamar OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se algum utilizador foi adicionado ou OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se algum utilizador foi removido. O método verifica o ID de membro para que responda apenas a atualizações relativas a membros que não o 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.TaskProtected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As TaskParâmetros
- turnContext
- ITurnContext<IConversationUpdateActivity>
Um objeto de contexto fortemente escrito para esta viragem.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser utilizado por outros objetos ou threads para receber aviso de cancelamento.
Devoluções
Uma tarefa que representa o trabalho em fila para executar.
Observações
Quando o OnTurnAsync(ITurnContext, CancellationToken) método recebe uma atividade de atualização de conversação, chama este método. Se a atividade de atualização de conversação indicar que membros que não o bot aderiram à conversação, chama OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Se a atividade de atualização da conversação indicar que os membros que não o bot deixaram a conversação, chama OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).
Numa classe derivada, substitua este método para adicionar lógica que se aplique a todas as atividades de atualização de conversação. Adicione lógica a aplicar antes de o membro adicionar ou remover a lógica antes da chamada para o método de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Adicione lógica a aplicar depois de o membro ter adicionado ou removido a lógica após a chamada para o método de classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.