ActivityHandler.OnEventActivityAsync 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à evento dal connettore quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le attività degli eventi possono essere usate per comunicare molte cose diverse. Per impostazione predefinita, questo metodo chiamerà OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) se il nome dell'attività è tokens/response o OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) meno. Un tokens/response evento può essere attivato da un OAuthCard.

protected virtual System.Threading.Tasks.Task OnEventActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> turnContext, System.Threading.CancellationToken cancellationToken);

abstract member OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnEventActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IEventActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Protected Overridable Function OnEventActivityAsync (turnContext As ITurnContext(Of IEventActivity), cancellationToken As CancellationToken) As Task

Parametri

turnContext: ITurnContext<IEventActivity>

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à evento, chiama questo metodo. Se l'evento Name è 'token/risposta', chiama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); altrimenti, chiama OnEventAsync(ITurnContext<IEventActivity>, CancellationToken).

In una classe derivata eseguire l'override di questo metodo per aggiungere logica applicabile a tutte le attività evento. Aggiungere logica da applicare prima della logica specifica di gestione degli eventi prima della chiamata al metodo della classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Aggiungere logica da applicare dopo la logica specifica di gestione degli eventi dopo la chiamata al metodo della classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base.

Le attività evento comunicano informazioni a livello di codice da un client o da un canale a un bot. Il significato di un'attività evento è definito dalla proprietà Name, che è significativa nell'ambito di un canale. Un evento "token/risposta" può essere attivato da un OAuthCard o da un prompt OAuth.

Si applica a