ActivityHandler.OnConversationUpdateActivityAsync Metoda

Definicja

Przestrzeń nazw:: Microsoft.Bot.Builder

Zestaw:: Microsoft.Bot.Builder.dll

Pakiet:: Microsoft.Bot.Builder v4.22.7

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wywoływane, gdy działanie aktualizacji konwersacji jest odbierane z kanału, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken). Działania aktualizacji rozmów są przydatne, gdy odpowiadamy na osoby dodane lub usuwane z rozmowy. Na przykład bot może odpowiedzieć użytkownikowi dodawanemu przez powitanie użytkownika. Domyślnie ta metoda sprawdza OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) , czy dodano OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) lub usunięto użytkowników. Metoda sprawdza identyfikator członka, aby odpowiadać tylko na aktualizacje dotyczące członków, poza samym botem.

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

Parametry

turnContext: ITurnContext<IConversationUpdateActivity>

Silnie wpisany obiekt kontekstowy dla tej tury.

cancellationToken: CancellationToken

Token anulowania, który może być używany przez inne obiekty lub wątki do otrzymywania powiadomienia o anulowaniu.

Zwraca

Task

Zadanie reprezentujące pracę w kolejce do wykonania.

Uwagi

Gdy metoda OnTurnAsync(ITurnContext, CancellationToken) odbiera działanie aktualizacji konwersacji, wywołuje tę metodę. Jeśli aktywność aktualizacji rozmowy wskazuje, że do rozmowy dołączyli inni członkowie niż bot, wywołuje OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)się . Jeśli aktywność aktualizacji rozmowy wskazuje, że członkowie inni niż bot opuścili rozmowę, wywołuje OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

W klasie pochodnej zastąp tę metodę, aby dodać logikę, która ma zastosowanie do wszystkich działań aktualizacji konwersacji. Dodaj logikę do zastosowania przed dodaniem lub usunięciem logiki członka przed wywołaniem metody klasy OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) bazowej. Dodaj logikę do zastosowania po dodaniu lub usunięciu logiki członka po wywołaniu metody klasy OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) bazowej.

Dotyczy