ActivityHandler.OnConversationUpdateActivityAsync Método

Definición

Espacio de nombres:: Microsoft.Bot.Builder

Ensamblado:: Microsoft.Bot.Builder.dll

Paquete:: Microsoft.Bot.Builder v4.22.7

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se invoca cuando se recibe una actividad de actualización de conversación desde el canal cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken). Las actividades de actualización de conversación son útiles cuando se trata de responder a los usuarios que se agregan o quitan de la conversación. Por ejemplo, un bot podría responder a un usuario que se va a agregar saludando al usuario. De forma predeterminada, este método llamará a OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) si se han agregado usuarios o OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) si se han quitado usuarios. El método comprueba el identificador de miembro para que solo responda a las actualizaciones con respecto a los miembros que no sean el propio bot.

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

Parámetros

turnContext: ITurnContext<IConversationUpdateActivity>

Un objeto de contexto fuertemente tipado para este turno.

cancellationToken: CancellationToken

Token de cancelación que otros objetos o subprocesos pueden usar para recibir un aviso de cancelación.

Devoluciones

Task

Tarea que representa el trabajo en cola que se va a ejecutar.

Comentarios

Cuando el método OnTurnAsync(ITurnContext, CancellationToken) recibe una actividad de actualización de conversación, llama a este método. Si la actividad de actualización de conversación indica que miembros distintos del bot se han unido a la conversación, llama OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)a . Si la actividad de actualización de conversación indica que miembros distintos al bot han abandonado la conversación, llama OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)a .

En una clase derivada, invalide este método para agregar lógica que se aplica a todas las actividades de actualización de conversación. Añadir lógica para aplicar antes de que el miembro añadiera o eliminara lógica antes de la llamada al método de clase OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Añadir lógica para aplicar después de que el miembro añadiera o eliminara lógica tras la llamada al método de clase OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.

Se aplica a