ActivityHandler.OnCommandActivityAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается при получении действия команды при использовании базового поведения .OnTurnAsync(ITurnContext, CancellationToken) Команды — это запросы на выполнение действия, а получатели обычно отвечают одним или несколькими действиями commandResult. Получатели также должны явно отклонять неподдерживаемые действия команд.
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 TaskПараметры
- turnContext
- ITurnContext<ICommandActivity>
Строго типизированный объект контекста для этого шага.
- cancellationToken
- CancellationToken
Токен отмены, который может использоваться другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Задача, представляющая работу, поставленную в очередь для выполнения.
Комментарии
OnTurnAsync(ITurnContext, CancellationToken) Когда метод получает действие команды, он вызывает этот метод.
В производном классе переопределите этот метод, чтобы добавить логику, которая применяется ко всем действиям comand. Добавьте логику, применяемую перед конкретной логикой обработки команд перед вызовом метода базового класса OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) . Добавьте логику, применяемую после конкретной логики обработки команд после вызова метода базового класса OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) .
Действия команд передают программную информацию от клиента или канала боту. Значение действия команды определяется свойством Name , которое имеет смысл в области канала.