ActivityHandler.OnConversationUpdateActivityAsync Metodo
Definizione
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 sono stati aggiunti utenti 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.TaskProtected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As TaskParametri
- turnContext
- ITurnContext<IConversationUpdateActivity>
Oggetto contesto fortemente tipizzato per questo turno.
- cancellationToken
- CancellationToken
Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.
Restituisce
Attività che rappresenta il lavoro in coda da eseguire.
Commenti
Quando il OnTurnAsync(ITurnContext, CancellationToken) metodo riceve un'attività di aggiornamento della conversazione, chiama questo metodo. Se l'attività di aggiornamento della conversazione indica che i 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 i 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 la logica da applicare prima dell'aggiunta o della rimozione della logica del membro prima della chiamata al metodo della classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Aggiungere la logica da applicare dopo che il membro ha aggiunto o rimosso la logica dopo la chiamata al metodo della classe OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.