ActivityHandler.OnCommandResultActivityAsync Método

Definição

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Pacote:: Microsoft.Bot.Builder v4.22.7

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 CommandResult é recebida quando o comportamento base de OnTurnAsync(ITurnContext, CancellationToken) é usado. As atividades CommandResult podem ser usadas para comunicar o resultado de uma execução de comando.

protected virtual System.Threading.Tasks.Task OnCommandResultActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandResultActivity> turnContext, System.Threading.CancellationToken cancellationToken);

abstract member OnCommandResultActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandResultActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnCommandResultActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.ICommandResultActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Protected Overridable Function OnCommandResultActivityAsync (turnContext As ITurnContext(Of ICommandResultActivity), cancellationToken As CancellationToken) As Task

Parâmetros

turnContext: ITurnContext<ICommandResultActivity>

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.

Retornos

Task

Uma tarefa que representa o trabalho enfileirado a ser executado.

Comentários

Quando o método OnTurnAsync(ITurnContext, CancellationToken) recebe uma atividade CommandResult, ele chama esse método.

Em uma classe derivada, substitua esse método para adicionar lógica que se aplica a todas as atividades de comand. Adicione lógica a ser aplicada antes da lógica específica de tratamento de CommandResult antes da chamada para a classe base OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken) método. Adicione lógica a ser aplicada após a lógica específica de tratamento de CommandResult após a chamada para a classe base OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken) método.

As atividades commandResult comunicam informações programáticas de um cliente ou canal para um bot. O significado de uma atividade CommandResult é definido pela Name propriedade que é significativa dentro do escopo de um canal.

Aplica-se a