ActivityHandler.OnEventActivityAsync Metodo

Definizione

Richiamato quando viene ricevuta un'attività evento dal connettore quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken) . Le attività di evento 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) in caso contrario. Un tokens/response evento può essere attivato da un oggetto 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>

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à evento, chiama questo metodo. Se l'evento Name è "tokens/response", chiama OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken); in caso contrario, 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 la logica da applicare prima della logica di gestione degli eventi specifica prima della chiamata al metodo della classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base. Aggiungere la logica da applicare dopo la logica di gestione degli eventi specifica dopo la chiamata al metodo della classe OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) base.

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

Si applica a

Vedi anche