ActivityHandler.OnCommandActivityAsync Método

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.

Invocado 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 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 tipado para este turno.

cancellationToken: CancellationToken

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

Devoluções

Task

Uma tarefa que representa o trabalho enfileirado para ser executado.

Observações

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

Numa classe derivada, sobrescreve este método para adicionar lógica que se aplique a todas as atividades de comand. Adicione lógica para aplicar antes da lógica específica de gestão de comandos antes da chamada para o método da classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base. Adicionar lógica para aplicar após a lógica específica de manuseamento de comandos após a chamada ao método da classe OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) base.

As atividades de comando comunicam informação programática de um cliente ou canal para um bot. O significado de uma atividade de comando é definido pela Name propriedade, que é significativa dentro do âmbito de um canal.

Aplica-se a