BotAdapter.RunPipelineAsync 方法

定义

命名空间:

Microsoft.Bot.Builder

程序集:

Microsoft.Bot.Builder.dll

包:

Microsoft.Bot.Builder v4.18.1

启动当前机器人轮次的活动处理。

protected System.Threading.Tasks.Task RunPipelineAsync (Microsoft.Bot.Builder.ITurnContext turnContext, Microsoft.Bot.Builder.BotCallbackHandler callback, System.Threading.CancellationToken cancellationToken);

member this.RunPipelineAsync : Microsoft.Bot.Builder.ITurnContext * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Protected Function RunPipelineAsync (turnContext As ITurnContext, callback As BotCallbackHandler, cancellationToken As CancellationToken) As Task

参数

turnContext

ITurnContext

轮次的上下文对象。

callback

BotCallbackHandler

在管道末尾运行的回调方法。

cancellationToken

CancellationToken

可由其他对象或线程用以接收取消通知的取消标记。

返回

Task

表示排队等待执行的工作的任务。

例外

ArgumentNullException

turnContext 为 null。

注解

适配器按添加的顺序调用中间件。 适配器传入回合的上下文对象和下一个委托，而中间件会调用该委托，将控制权传递给管道中的下一个中间件 。 一旦控件到达管道的末尾，适配器就会调用 callback 方法。 如果中间件组件不调用下一个委托，则适配器不会调用任何后续中间件 OnTurnAsync(ITurnContext, NextDelegate, CancellationToken) 的方法或回调方法，并且管道短路。

当用户活动 (反应性消息传送) 启动轮次时，回调方法将是对机器人方法的 OnTurnAsync(ITurnContext, CancellationToken) 引用。 当通过调用 ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken) (主动消息传送) 启动轮次时，回调方法是调用中提供的回调方法。