ActivityHandler.OnEventActivityAsync Método
Definição
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 evento é recebida do conector quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é usado.
As atividades de evento podem ser usadas para comunicar várias coisas diferentes.
Por padrão, esse método chamará OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) se o nome da atividade for tokens/response ou OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) não.
Um tokens/response evento pode ser desencadeado por um OAuthCard.
protected virtual System.Threading.Tasks.Task OnEventActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> turnContext, System.Threading.CancellationToken cancellationToken);abstract member OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskProtected Overridable Function OnEventActivityAsync (turnContext As ITurnContext(Of IEventActivity), cancellationToken As CancellationToken) As TaskParâmetros
- turnContext
- ITurnContext<IEventActivity>
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
Uma tarefa que representa o trabalho enfileirado a ser executado.
Comentários
Quando o método OnTurnAsync(ITurnContext, CancellationToken) recebe uma atividade de evento, ele chama esse método. Se o evento Name for 'tokens/resposta', ele chama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); caso contrário, chama OnEventAsync(ITurnContext<IEventActivity>, CancellationToken).
Em uma classe derivada, substitua esse método para adicionar a lógica que se aplica a todas as atividades de evento. Adicione lógica para aplicar antes da lógica específica de gerenciamento de eventos antes da chamada ao método de classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Adicione lógica para aplicar após a lógica específica de gerenciamento de eventos após a chamada para o método da classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base.
As atividades de evento comunicam informações programáticas de um cliente ou canal para um bot. O significado de uma atividade de evento é definido pela propriedade Name, que é significativa dentro do escopo de um canal. Um evento "tokens/resposta" pode ser disparado por um OAuthCard ou um prompt OAuth.