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.
Aangeroepen wanneer een activiteit van een gespreksupdate wordt ontvangen van het kanaal wanneer het basisgedrag van OnTurnAsync(ITurnContext, CancellationToken) wordt gebruikt. Gespreksupdate-activiteiten zijn handig als het gaat om het reageren op gebruikers die aan het gesprek worden toegevoegd of verwijderd. Een bot kan bijvoorbeeld reageren op een gebruiker die wordt toegevoegd door de gebruiker te begroeten. Standaard roept OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) deze methode aan als er gebruikers zijn toegevoegd of OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) verwijderd. De methode controleert de lid-ID zodat deze alleen reageert op updates over leden anders 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 sterk getypeerd contextobject voor deze beurt.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om 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 activiteit voor het bijwerken van gesprekken ontvangt, wordt deze methode aangeroepen. Als de conversatie-update-activiteit aangeeft dat leden anders dan de bot aan het gesprek zijn deelgenomen, roept OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)het . Als de conversatie-update-activiteit aangeeft dat leden anders dan de bot het gesprek hebben verlaten, roept OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)het aan .
In een afgeleide klasse overschrijft u deze methode om logica toe te voegen die van toepassing is op alle activiteiten voor het bijwerken van gesprekken. Voeg logica toe om toe te passen voordat het lid logica toevoegde of verwijderde vóór de aanroep van de basisklasse-methode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) . Voeg logica toe die toegepast wordt nadat het lid logica heeft toegevoegd of verwijderd na de aanroep van de basisklassemethode OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) .