DialogContext.EndDialogAsync(Object, CancellationToken) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Termina una finestra di dialogo eliminando lo stack e restituisce un risultato facoltativo all'elemento padre della finestra di dialogo. La finestra di dialogo padre è la finestra di dialogo avviata in corso tramite una chiamata a BeginDialogAsync(String, Object, CancellationToken) o PromptAsync(String, PromptOptions, CancellationToken). La finestra di dialogo padre avrà il ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) relativo metodo richiamato con qualsiasi risultato restituito. Se la finestra di dialogo padre non ha implementato un ResumeDialogAsync
metodo, verrà terminata automaticamente e il risultato passato al relativo padre.
Se non sono presenti più dialoghi padre nello stack, l'elaborazione del turno terminerà.
public System.Threading.Tasks.Task<Microsoft.Bot.Builder.Dialogs.DialogTurnResult> EndDialogAsync (object result = default, System.Threading.CancellationToken cancellationToken = default);
member this.EndDialogAsync : obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Builder.Dialogs.DialogTurnResult>
Public Function EndDialogAsync (Optional result As Object = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DialogTurnResult)
Parametri
- result
- Object
Facoltativo, risultato da passare al contesto padre.
- cancellationToken
- CancellationToken
Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.
Restituisce
Attività che rappresenta la coda di lavoro da eseguire.
Commenti
Se l'attività ha esito positivo, il risultato indica che la finestra di dialogo è terminata dopo l'elaborazione della finestra di dialogo.
In generale, il contesto padre è il gestore dei turni di dialogo o bot che ha avviato la finestra di dialogo. Se l'elemento padre è una finestra di dialogo, lo stack chiama il metodo padre per restituire un risultato alla finestra di ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) dialogo padre. Se la finestra di dialogo padre non implementa 'ResumeDialogAsync', anche l'elemento padre termina e il risultato passato al contesto padre successivo.
Il restituito contiene il valore restituito DialogTurnResult nella relativa Result proprietà.