ActivityHandler.OnEventActivityAsync Método

Definición

Espacio de nombres:: Microsoft.Bot.Builder

Ensamblado:: Microsoft.Bot.Builder.dll

Paquete:: Microsoft.Bot.Builder v4.22.7

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se invoca cuando se recibe una actividad de evento del conector cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken). Las actividades de eventos se pueden usar para comunicar muchas cosas diferentes. Por defecto, este método llamará OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) si el nombre de la actividad es tokens/response o OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) no. Un tokens/response evento puede ser desencadenado por un 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>

Un objeto de contexto fuertemente tipado para este turno.

cancellationToken: CancellationToken

Token de cancelación que otros objetos o subprocesos pueden usar para recibir un aviso de cancelación.

Devoluciones

Task

Tarea que representa el trabajo en cola que se va a ejecutar.

Comentarios

Cuando el método OnTurnAsync(ITurnContext, CancellationToken) recibe una actividad de evento, llama a este método. Si el evento Name es 'tokens/respuesta', llama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); de lo contrario, llama OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)a .

En una clase derivada, invalide este método para agregar lógica que se aplica a todas las actividades de eventos. Añadir lógica para aplicar antes de la lógica específica de gestión de eventos antes de la llamada al método de clase OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Añadir lógica para aplicar después de la lógica específica de gestión de eventos tras la llamada al método de clase OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base.

Las actividades de eventos comunican información mediante programación de un cliente o canal a un bot. El significado de una actividad de evento se define mediante la propiedad Name, que es significativa dentro del ámbito de un canal. Un evento "tokens/respuesta" se puede desencadenar mediante un OAuthCard o un mensaje de OAuth.

Se aplica a