語言

BotAdapter.RunPipelineAsync 方法

定義

啟動目前 Bot 回合的活動處理。

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

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

工作,表示要執行的工作佇列。

例外狀況

turnContext 為 null。

備註

配接器會依您新增中間件的順序呼叫中間件。 配接器會在回合和下一個委派的內容對象中傳遞,中間件會呼叫委派,以將控制權傳遞至管線中的下一個中間件。 一旦控件到達管線的結尾,配接器就會呼叫 callback 方法。 如果中介軟體元件沒有呼叫下一個代理,介面卡也不會呼叫後續中介軟體 OnTurnAsync(ITurnContext, NextDelegate, CancellationToken) 的方法或回調方法,管線就會短路。

當用戶活動 (回應傳訊) 起始回合時,回呼方法會是 Bot OnTurnAsync(ITurnContext, CancellationToken) 方法的參考。 當回合由呼叫 ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken) (主動傳訊) 起始時,回呼方法是呼叫中提供的回呼方法。

適用於