ActivityHandler.OnCommandActivityAsync Methode

Referenz

Definition

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.18.1

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 Befehlsaktivität empfangen wird, wenn das Basisverhalten von OnTurnAsync(ITurnContext, CancellationToken) verwendet wird. Befehle sind Anforderungen zum Ausführen einer Aktion, und Empfänger reagieren in der Regel mit einer oder mehreren commandResult-Aktivitäten. Es wird auch erwartet, dass Empfänger nicht unterstützte Befehlsaktivitäten explizit ablehnen.

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

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

Protected Overridable Function OnCommandActivityAsync (turnContext As ITurnContext(Of ICommandActivity), cancellationToken As CancellationToken) As Task

Parameter

turnContext: ITurnContext<ICommandActivity>

Ein stark typisiertes Kontextobjekt für diesen Turn.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.

Gibt zurück

Task

Eine Aufgabe, die die auszuführende Arbeit in der Warteschlange darstellt.

Hinweise

Wenn die OnTurnAsync(ITurnContext, CancellationToken) -Methode eine Befehlsaktivität empfängt, ruft sie diese Methode auf.

Überschreiben Sie in einer abgeleiteten Klasse diese Methode, um Logik hinzuzufügen, die für alle Comand-Aktivitäten gilt. Fügen Sie Logik hinzu, die vor der spezifischen Befehlsverarbeitungslogik vor dem Aufruf der Basisklassenmethode OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) angewendet werden soll. Fügen Sie Logik hinzu, die nach der spezifischen Befehlsverarbeitungslogik nach dem Aufruf der Basisklassenmethode OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) angewendet werden soll.

Befehlsaktivitäten kommunizieren programmgesteuerte Informationen von einem Client oder Kanal an einen Bot. Die Bedeutung einer Befehlsaktivität wird durch die Name -Eigenschaft definiert, die innerhalb des Bereichs eines Kanals sinnvoll ist.

Gilt für:

Freigeben über