ActivityHandler.OnEventActivityAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在使用 的基本行为 OnTurnAsync(ITurnContext, CancellationToken) 时，从连接器接收事件活动时调用。
事件活动可用于传达许多不同的内容。
默认情况下，如果活动的名称为 tokens/response 或其他OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)，此方法将调用 OnTokenResponseEventAsync(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 属性定义，该属性在通道范围内有意义。 “tokens/response”事件可由 或 OAuth 提示符触发 OAuthCard 。