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) メソッドの呼び出し後にメンバーがロジックを追加または削除した後に適用するロジックを追加します。