ActivityHandler.OnCommandActivityAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wywoływane po otrzymaniu aktywności polecenia, gdy użyto zachowania OnTurnAsync(ITurnContext, CancellationToken) bazowego. Polecenia to żądania wykonania akcji, a odbiorcy zazwyczaj odpowiadają jedną lub kilkoma aktywnościami Result. Od odbiorców oczekuje się również, że wyraźnie odrzucają nieobsługiwane działania poleceń.
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
Parametry
- turnContext
- ITurnContext<ICommandActivity>
Silnie wpisany obiekt kontekstowy dla tej tury.
- cancellationToken
- CancellationToken
Token anulowania, który może być używany przez inne obiekty lub wątki do otrzymywania powiadomienia o anulowaniu.
Zwraca
Zadanie reprezentujące pracę w kolejce do wykonania.
Uwagi
Gdy metoda otrzymuje OnTurnAsync(ITurnContext, CancellationToken) aktywność polecenia, wywołuje ją.
W klasie pochodnej można nadpisać tę metodę, aby dodać logikę stosującą się do wszystkich działań comand. Dodaj logikę do zastosowania przed konkretną logiką obsługi poleceń przed wywołaniem metody klasy OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) bazowej. Dodaj logikę, która stosuje się po konkretnej logice obsługi poleceń po wywołaniu metody klasy OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) bazowej.
Działania komendowe przekazują informacje programowe od klienta lub kanału do bota. Znaczenie czynności poleceń definiuje właściwość Name , która ma znaczenie w ramach kanału.