Partilhar via


ActivityHandler.OnEventActivityAsync Método

Definição

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.

Aplica-se a

Ver também