ActivityHandler.OnCommandActivityAsync Método
Definición
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 comando cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Los comandos son solicitudes para realizar una acción y los receptores suelen responder con una o varias actividades commandResult. También se espera que los receptores rechacen explícitamente las actividades de comandos no admitidas.
protected virtual System.Threading.Tasks.Task OnCommandActivityAsync (Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandActivity> turnContext, System.Threading.CancellationToken cancellationToken);
abstract member OnCommandActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnCommandActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Protected Overridable Function OnCommandActivityAsync (turnContext As ITurnContext(Of ICommandActivity), cancellationToken As CancellationToken) As Task
Parámetros
- turnContext
- ITurnContext<ICommandActivity>
Objeto de contexto fuertemente tipado para este turno.
- cancellationToken
- CancellationToken
Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.
Devoluciones
Tarea que representa el trabajo en cola que se va a ejecutar.
Comentarios
Cuando el OnTurnAsync(ITurnContext, CancellationToken) método recibe una actividad de comando, llama a este método.
En una clase derivada, invalide este método para agregar lógica que se aplica a todas las actividades de comand. Agregue lógica para aplicarla antes de la lógica de control de comandos específica antes de la llamada al método de clase OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base. Agregue lógica para aplicar después de la lógica de control de comandos específica después de la llamada al método de clase OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base.
Las actividades de comandos comunican información mediante programación de un cliente o canal a un bot. El significado de una actividad de comando se define mediante la Name propiedad , que es significativa dentro del ámbito de un canal.