ActivityHandler.OnConversationUpdateActivityAsync Método

Referencia

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á 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 distintos del 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>

Objeto de contexto fuertemente tipado para este turno.

cancellationToken: CancellationToken

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

Devoluciones

Task

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

Comentarios

Cuando el OnTurnAsync(ITurnContext, CancellationToken) método 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 los miembros distintos del bot se unieron a la conversación, llama a OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). Si la actividad de actualización de conversación indica que los miembros que no son del bot dejan la conversación, llama a OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

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. Agregue lógica para aplicar antes de que el miembro agregue o quite la lógica antes de la llamada al método de clase OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base. Agregue lógica para aplicar después de que el miembro haya agregado o quitado la lógica después de la llamada al método de clase OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) base.

Se aplica a

Compartir a través de