ActivityHandler.OnConversationUpdateActivityAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wordt aangeroepen wanneer een gespreksupdateactiviteit wordt ontvangen van het kanaal wanneer het basisgedrag van OnTurnAsync(ITurnContext, CancellationToken) wordt gebruikt. Gespreksupdateactiviteiten zijn handig als het gaat om het reageren op gebruikers die worden toegevoegd aan of verwijderd uit het gesprek. Een bot kan bijvoorbeeld reageren op een gebruiker die wordt toegevoegd door de gebruiker te begroeten. Met deze methode wordt standaard aangeroepen OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) als er gebruikers zijn toegevoegd of OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) als er gebruikers zijn verwijderd. De methode controleert de lid-id, zodat deze alleen reageert op updates met betrekking tot andere leden dan de bot zelf.
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 TaskParameters
- turnContext
- ITurnContext<IConversationUpdateActivity>
Een contextobject met een sterk type voor deze beurt.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om een kennisgeving van annulering te ontvangen.
Retouren
Een taak die het werk vertegenwoordigt dat in de wachtrij staat om uit te voeren.
Opmerkingen
Wanneer de OnTurnAsync(ITurnContext, CancellationToken) methode een gespreksupdateactiviteit ontvangt, wordt deze methode aangeroepen. Als de gespreksupdateactiviteit aangeeft dat andere leden dan de bot deelnemen aan het gesprek, wordt aangeroepen OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Als de gespreksupdateactiviteit aangeeft dat andere leden dan de bot het gesprek hebben verlaten, wordt aangeroepen OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).
In een afgeleide klasse overschrijft u deze methode om logica toe te voegen die van toepassing is op alle gespreksupdateactiviteiten. Voeg logica toe die moet worden toegepast voordat het lid logica heeft toegevoegd of verwijderd vóór de aanroep van de basisklassemethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) . Voeg logica toe om toe te passen nadat het lid logica heeft toegevoegd of verwijderd na de aanroep van de basisklassemethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) .