ActivityHandler.OnEventActivityAsync Método

Referência

Definição

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Pacote:: Microsoft.Bot.Builder v4.22.7

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 muitas 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 disparado 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 um aviso de cancelamento.

Retornos

Task

Uma tarefa que representa o trabalho enfileirado a ser executado.

Comentários

Quando o OnTurnAsync(ITurnContext, CancellationToken) método recebe uma atividade de evento, ele chama esse método. Se o evento Name for 'tokens/response', ele chamará OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); caso contrário, ele chamará 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 a ser aplicada antes da lógica específica de manipulação de eventos antes da chamada para o método de classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Adicione lógica a ser aplicada após a lógica específica de manipulação de eventos 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 é significativa dentro do escopo de um canal. Um evento 'tokens/response' pode ser disparado por um OAuthCard prompt ou OAuth.

Aplica-se a

Compartilhar via