共用方式為


ActivityHandler.OnConversationUpdateActivityAsync 方法

定義

使用 的基底行為 OnTurnAsync(ITurnContext, CancellationToken) 時,從通道接收交談更新活動時叫用。 交談更新活動在回應要新增或從交談中移除的使用者時很有用。 例如,Bot 可以藉由問候使用者來回應要新增的使用者。 根據預設,如果已新增任何使用者,或 OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) 已移除任何使用者,這個方法會呼叫 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) 。 方法會檢查成員識別碼,使其只會回應 Bot 本身以外的成員的更新。

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.Task
Protected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As Task

參數

turnContext
ITurnContext<IConversationUpdateActivity>

這個回合的強型別內容物件。

cancellationToken
CancellationToken

取消語彙基元,可由其他物件或執行緒用來接收取消通知。

傳回

工作,表示要執行的工作已排入佇列。

備註

OnTurnAsync(ITurnContext, CancellationToken)當方法收到交談更新活動時,它會呼叫這個方法。 如果交談更新活動指出 Bot 以外的成員已加入交談,則會呼叫 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) 。 如果交談更新活動指出 Bot 以外的成員離開交談,則會呼叫 OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

在衍生類別中,覆寫這個方法,以新增套用至所有交談更新活動的邏輯。 在呼叫基類 OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) 方法之前新增或移除成員之前要套用的邏輯。 在呼叫基類 OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) 方法之後新增或移除成員之後要套用的邏輯。

適用於

另請參閱