ActivityHandler.OnCommandActivityAsync Método
Definição
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 comando é recebida quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é usado. Comandos são solicitações para executar uma ação e os receptores normalmente respondem com uma ou mais atividades commandResult. Espera-se também que os receptores rejeitem explicitamente atividades de comando sem suporte.
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.TaskProtected Overridable Function OnCommandActivityAsync (turnContext As ITurnContext(Of ICommandActivity), cancellationToken As CancellationToken) As TaskParâmetros
- turnContext
- ITurnContext<ICommandActivity>
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
Uma tarefa que representa o trabalho enfileirado a ser executado.
Comentários
Quando o OnTurnAsync(ITurnContext, CancellationToken) método recebe uma atividade de comando, ele chama esse método.
Em uma classe derivada, substitua esse método para adicionar a lógica que se aplica a todas as atividades de comand. Adicione lógica a ser aplicada antes da lógica de tratamento de comando específica antes da chamada para o método de classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base. Adicione lógica a ser aplicada após a lógica de tratamento de comando específica após a chamada para o método de classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base.
As atividades de comando comunicam informações programáticas de um cliente ou canal para um bot. O significado de uma atividade de comando é definido pela Name propriedade , que é significativa dentro do escopo de um canal.