ActivityHandler.OnEventActivityAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird aufgerufen, wenn eine Ereignisaktivität vom Connector empfangen wird, wenn das Basisverhalten von OnTurnAsync(ITurnContext, CancellationToken) verwendet wird.
Ereignisaktivitäten können verwendet werden, um viele verschiedene Dinge zu kommunizieren.
Standardmäßig ruft diese Methode auf, OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) ob die Aktivität tokens/response heißt oder OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) nicht.
Ein Ereignis kann durch ein OAuthCardausgelöst tokens/response werden.
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
Parameter
- turnContext
- ITurnContext<IEventActivity>
Ein stark typisiertes Kontextobjekt für diese Runde.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Eine Aufgabe, die die auszuführende Arbeitswarteschlange darstellt.
Hinweise
Wenn die OnTurnAsync(ITurnContext, CancellationToken)-Methode eine Ereignisaktivität empfängt, ruft sie diese Methode auf. Wenn das Ereignis Name 'Tokens/Response' ist, ruft OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)es ; andernfalls ruft OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)es .
Überschreiben Sie in einer abgeleiteten Klasse diese Methode, um Logik hinzuzufügen, die für alle Ereignisaktivitäten gilt. Fügen Sie Logik hinzu, die vor der spezifischen Ereignishandhabungslogik angewendet wird, bevor die Basisklassenmethode OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) aufgerufen wird. Fügen Sie Logik hinzu, die nach der spezifischen Ereignishandhabungslogik nach dem Aufruf der Basisklassenmethode OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) angewendet wird.
Ereignisaktivitäten kommunizieren programmgesteuerte Informationen von einem Client oder Kanal an einen Bot. Die Bedeutung einer Ereignisaktivität wird durch die Name-Eigenschaft definiert, die innerhalb des Bereichs eines Kanals aussagekräftig ist. Ein "token/response"-Ereignis kann durch eine OAuthCard oder eine OAuth-Eingabeaufforderung ausgelöst werden.