DialogContext.EndDialogAsync(Object, CancellationToken) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee beëindigt u een dialoogvenster door het uit de stapel te halen en wordt een optioneel resultaat geretourneerd naar het bovenliggende dialoogvenster. Het bovenliggende dialoogvenster is het dialoogvenster dat is gestart en wordt beëindigd via een aanroep naar BeginDialogAsync(String, Object, CancellationToken) of PromptAsync(String, PromptOptions, CancellationToken). De methode van het bovenliggende dialoogvenster wordt ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) aangeroepen met elk geretourneerd resultaat. Als het bovenliggende dialoogvenster geen methode heeft geïmplementeerd ResumeDialogAsync , wordt deze ook automatisch beëindigd en wordt het resultaat doorgegeven aan het bovenliggende dialoogvenster.
Als er geen bovenliggende dialoogvensters meer op de stapel staan, wordt de verwerking van de beurt beëindigd.
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)Parameters
- result
- Object
Optioneel, resultaat om door te geven aan de bovenliggende context.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om een kennisgeving van annulering te ontvangen.
Retouren
Een taak die het werk vertegenwoordigt dat in de wachtrij staat om uit te voeren.
Opmerkingen
Als de taak is geslaagd, geeft het resultaat aan dat het dialoogvenster is beëindigd nadat de beurt door het dialoogvenster is verwerkt.
In het algemeen is de bovenliggende context het dialoogvenster of de bot turn handler die het dialoogvenster heeft gestart. Als het bovenliggende dialoogvenster een dialoogvenster is, roept de stack de methode van ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) het bovenliggende item aan om een resultaat te retourneren naar het bovenliggende dialoogvenster. Als het bovenliggende dialoogvenster 'ResumeDialogAsync' niet implementeert, wordt het bovenliggende dialoogvenster ook beëindigd en wordt het resultaat doorgegeven aan de volgende bovenliggende context.
De geretourneerde bevat de geretourneerde DialogTurnResult waarde in de eigenschap.Result