ActivityHandler.OnConversationUpdateActivityAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，從通道接收交談更新活動時叫用。 交談更新活動在回應要新增或從交談中移除的使用者時很有用。 例如，Bot 可以藉由問候用戶來回應所新增的使用者。 根據預設，如果已新增任何使用者，或已移除任何使用者 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)，則此方法會呼叫 OnMembersRemovedAsync(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.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) 方法後新增或移除邏輯後，新增邏輯以套用。