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) 方法之後，新增要套用的特定命令處理邏輯。
命令活動會將程式設計資訊從用戶端或通道傳達給 Bot。 指令活動的意義由 Name 屬性定義，而該屬性在通道範圍內具有意義。