ActivityHandler.OnCommandActivityAsync Método

Referência

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.

Invocada quando uma atividade de comando é recebida quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é utilizado. Os comandos são pedidos para executar uma ação e os recetores normalmente respondem com uma ou mais atividades commandResult. Espera-se também que os recetores rejeitem explicitamente as atividades de comando não suportadas.

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>

Um objeto de contexto fortemente escrito para esta viragem.

cancellationToken: CancellationToken

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

Devoluções

Task

Uma tarefa que representa o trabalho em fila de trabalho a executar.

Observações

Quando o OnTurnAsync(ITurnContext, CancellationToken) método recebe uma atividade de comando, chama este método.

Numa classe derivada, substitua este método para adicionar lógica que se aplica a todas as atividades de comand. Adicione lógica a aplicar antes da lógica de processamento de comandos específica antes da chamada para o método de classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base. Adicione lógica a aplicar após a lógica de processamento de comandos 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 propriedade, que Name é relevante no âmbito de um canal.

Aplica-se a

Partilhar via