ActivityHandler.OnEventActivityAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，從連接器接收事件活動時叫用。
事件活動可用來傳達許多不同的專案。
預設情況下，這個方法會呼叫OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)活動名稱是否正確tokens/responseOnEventAsync(ITurnContext<IEventActivity>, CancellationToken)。
tokens/response事件可由 OAuthCard觸發。
protected virtual System.Threading.Tasks.Task OnEventActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> turnContext, System.Threading.CancellationToken cancellationToken);abstract member OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskProtected Overridable Function OnEventActivityAsync (turnContext As ITurnContext(Of IEventActivity), cancellationToken As CancellationToken) As Task參數
- turnContext
- ITurnContext<IEventActivity>
本回合的強型態上下文物件。
- cancellationToken
- CancellationToken
一種可被其他物件或執行緒用來接收取消通知的取消標記。
傳回
工作，表示要執行的工作佇列。
備註
當 OnTurnAsync(ITurnContext, CancellationToken) 方法收到事件活動時，它會呼叫此方法。 若事件 Name 為「tokens/response」，則呼叫 OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken);否則，呼叫 OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)。
在衍生類別中，覆寫此方法以新增適用於所有事件活動的邏輯。 在呼叫基類 OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) 方法之前，先加入邏輯以套用特定事件處理邏輯。 在呼叫基底類 OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) 方法後，新增邏輯以套用特定事件處理邏輯。
事件活動會將程式設計資訊從用戶端或通道傳達給 Bot。 事件活動的意義是由 Name 屬性所定義，此屬性在通道範圍內有意義。 「令牌/回應」事件可由 OAuthCard 或 OAuth 提示觸發。