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 屬性所定義，這在通道的範圍內有意義。