Språk

ActivityHandler.OnConversationUpdateActivityAsync Metod

Definition

Anropas när en konversationsuppdateringsaktivitet tas emot från kanalen när basbeteendet för OnTurnAsync(ITurnContext, CancellationToken) används. Aktiviteter för konversationsuppdateringar är användbara när det gäller att svara på användare som läggs till eller tas bort från konversationen. En robot kan till exempel svara på en användare som läggs till genom att hälsa på användaren. Som standard anropar OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) denna metod om några användare har lagts till eller OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) om några har tagits bort. Metoden kontrollerar medlems-ID så att den bara svarar på uppdateringar om andra medlemmar än själva boten.

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

Parametrar

turnContext
ITurnContext<IConversationUpdateActivity>

Ett starkt typat kontextobjekt för denna tur.

cancellationToken
CancellationToken

En annulleringstoken som kan användas av andra objekt eller trådar för att få meddelande om annullering.

Returer

En uppgift som representerar det arbete som ska köras i kö.

Kommentarer

När OnTurnAsync(ITurnContext, CancellationToken)-metoden tar emot en konversationsuppdateringsaktivitet anropas den här metoden. Om aktiviteten för konversationsuppdatering visar att andra medlemmar än boten har gått med i konversationen, anropar OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)den . Om aktiviteten för konversationsuppdatering indikerar att medlemmar andra än boten lämnade konversationen, anropar OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)den .

I en härledd klass åsidosätter du den här metoden för att lägga till logik som gäller för alla konversationsuppdateringsaktiviteter. Lägg till logik som ska tillämpas innan medlemmen lade till eller tog bort logik innan anropet av basklassmetoden OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) . Lägg till logik som tillämpas efter att medlemmen lagt till eller tagit bort logik efter anropet till basklassmetoden OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) .

Gäller för

Se även