ActivityHandler.OnConversationUpdateActivityAsync Metodo

Definizione

Spazio dei nomi:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Pacchetto:: Microsoft.Bot.Builder v4.22.7

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Richiamato quando viene ricevuta un'attività di aggiornamento della conversazione dal canale quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le attività di aggiornamento della conversazione sono utili quando si tratta di rispondere agli utenti aggiunti o rimossi dalla conversazione. Ad esempio, un bot potrebbe rispondere a un utente aggiunto salutando l'utente. Per impostazione predefinita, questo metodo chiamerà OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se gli utenti sono stati aggiunti o OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se sono stati rimossi utenti. Il metodo controlla l'ID membro in modo che risponda solo agli aggiornamenti relativi ai membri diversi dal bot stesso.

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

Parametri

turnContext: ITurnContext<IConversationUpdateActivity>

Un oggetto contestuale fortemente tipizzato per questa svolta.

cancellationToken: CancellationToken

Token di annullamento che può essere utilizzato da altri oggetti o thread per ricevere un avviso di annullamento.

Valori restituiti

Task

Attività che rappresenta il lavoro in coda da eseguire.

Commenti

Quando il metodo OnTurnAsync(ITurnContext, CancellationToken) riceve un'attività di aggiornamento della conversazione, chiama questo metodo. Se l'attività di aggiornamento della conversazione indica che membri diversi dal bot si sono uniti alla conversazione, chiama OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Se l'attività di aggiornamento della conversazione indica che membri diversi dal bot hanno lasciato la conversazione, chiama OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

In una classe derivata eseguire l'override di questo metodo per aggiungere logica applicabile a tutte le attività di aggiornamento della conversazione. Aggiungere logica da applicare prima che il membro aggiungesse o rimuovesse logica prima della chiamata al metodo di classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Aggiungere logica da applicare dopo che il membro ha aggiunto o rimosso logica dopo la chiamata al metodo di classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.

Si applica a