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) 方法后，添加应用逻辑，在特定的事件处理逻辑之后。
事件活动将来自客户端或通道的编程信息传达给机器人。 事件活动的含义由 Name 属性定义，该属性在通道范围内有意义。 可以通过 OAuthCard 或 OAuth 提示触发“令牌/响应”事件。