ActivityHandler.OnEventActivityAsync Método

Definição

Espaço de Nomes:: Microsoft.Bot.Builder

Assemblagem:: Microsoft.Bot.Builder.dll

Pacote:: Microsoft.Bot.Builder v4.22.7

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 do OnTurnAsync(ITurnContext, CancellationToken) é usado. As atividades de eventos podem ser usadas para comunicar muitas coisas diferentes. Por defeito, este método chama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) se o nome da atividade é 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.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 tipado para este turno.

cancellationToken: CancellationToken

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

Devoluções

Task

Uma tarefa que representa o trabalho enfileirado para ser executado.

Observações

Quando o método OnTurnAsync(ITurnContext, CancellationToken) recebe uma atividade de evento, ele chama esse método. Se o evento Name for 'tokens/resposta', chama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); caso contrário, chama OnEventAsync(ITurnContext<IEventActivity>, CancellationToken).

Em uma classe derivada, substitua esse método para adicionar lógica que se aplica a todas as atividades de evento. Adicione lógica para aplicar antes da lógica específica de gestão de eventos antes da chamada para o método da classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Adicionar lógica para aplicar após a lógica específica de gestão de eventos após a chamada ao método da classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base.

As atividades do 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 é significativa dentro do âmbito de um canal. Um evento de 'tokens/resposta' pode ser desencadeado por um OAuthCard ou um prompt OAuth.

Aplica-se a