ActivityHandler.OnCommandActivityAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在使用 的基本行为 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 属性定义，该属性在通道范围内有意义。