ActivityHandler.OnConversationUpdateActivityAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在使用 的基本行为 OnTurnAsync(ITurnContext, CancellationToken) 时，从通道接收会话更新活动时调用。 在响应在对话中添加或删除的用户时，对话更新活动非常有用。 例如，机器人可以通过问候用户来响应正在添加的用户。 默认情况下，如果已添加任何用户或OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)已删除任何用户，此方法将调用 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) 。 方法检查成员 ID，以便它仅响应有关机器人本身以外的成员的更新。
protected virtual System.Threading.Tasks.Task OnConversationUpdateActivityAsync (Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> turnContext, System.Threading.CancellationToken cancellationToken);abstract member OnConversationUpdateActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnConversationUpdateActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskProtected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As Task参数
- turnContext
- ITurnContext<IConversationUpdateActivity>
此轮次的强类型上下文对象。
- cancellationToken
- CancellationToken
可由其他对象或线程用以接收取消通知的取消标记。
返回
表示排队等待执行的工作的任务。
注解
OnTurnAsync(ITurnContext, CancellationToken)当 方法收到会话更新活动时，它会调用此方法。 如果聊天更新活动指示机器人以外的其他成员已加入聊天，它将调用 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)。 如果聊天更新活动指示机器人以外的其他成员离开了聊天，则它会调用 OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)。
在派生类中，重写此方法以添加适用于所有聊天更新活动的逻辑。 在调用基类 OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) 方法之前，在成员添加或删除逻辑之前添加要应用的逻辑。 在调用基类 OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) 方法后，在添加或删除逻辑的成员之后添加要应用的逻辑。