ActivityHandler.OnEventActivityAsync 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.
Invocado quando uma atividade de evento é recebida do conector quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é utilizado.
As atividades de eventos podem ser utilizadas para comunicar muitas coisas diferentes.
Por predefinição, este método irá chamar OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) se o nome da atividade é tokens/response
ou OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) não.
Um tokens/response
evento pode ser acionado 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.Task
Protected Overridable Function OnEventActivityAsync (turnContext As ITurnContext(Of IEventActivity), cancellationToken As CancellationToken) As Task
Parâmetros
- turnContext
- ITurnContext<IEventActivity>
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 de trabalho a executar.
Observações
Quando o OnTurnAsync(ITurnContext, CancellationToken) método recebe uma atividade de evento, chama este método. Se o evento Name for "tokens/response", chama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); caso contrário, chama OnEventAsync(ITurnContext<IEventActivity>, CancellationToken).
Numa classe derivada, substitua este método para adicionar lógica que se aplica a todas as atividades de eventos. Adicione lógica a aplicar antes da lógica de processamento de eventos específica antes da chamada para o método de classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Adicione lógica a aplicar após a lógica de processamento de eventos específica após a chamada para o método de 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 Name propriedade, que é relevante no âmbito de um canal. Um evento "tokens/response" pode ser acionado por um OAuthCard pedido ou OAuth.