ActivityHandler.OnCommandActivityAsync 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 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. Empfänger werden auch erwartet, dass nicht unterstützte Befehlsaktivitäten explizit abgelehnt werden.
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.TaskProtected Overridable Function OnCommandActivityAsync (turnContext As ITurnContext(Of ICommandActivity), cancellationToken As CancellationToken) As TaskParameter
- turnContext
- ITurnContext<ICommandActivity>
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 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 Comandaktivitäten gilt. Fügen Sie vor dem Aufruf der Basisklasse OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) Methode Logik hinzu, die vor der spezifischen Befehlsbehandlungslogik angewendet werden soll. Fügen Sie logik hinzu, die nach der spezifischen Befehlsbehandlungslogik nach dem Aufruf der Basisklasse OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) Methode angewendet werden soll.
Befehlsaktivitäten kommunizieren programmgesteuerte Informationen von einem Client oder Kanal an einen Bot. Die Bedeutung einer Befehlsaktivität wird durch die Eigenschaft Name definiert, die innerhalb des Bereichs eines Kanals sinnvoll ist.