次の方法で共有


DialogContext.EndDialogAsync(Object, CancellationToken) メソッド

定義

スタックからダイアログをポップしてダイアログを終了し、オプションの結果をダイアログの親に返します。 親ダイアログは、 または PromptAsync(String, PromptOptions, CancellationToken)の呼び出しBeginDialogAsync(String, Object, CancellationToken)によって終了するで開始された ダイアログです。 親ダイアログには、 ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) 返された結果でメソッドが呼び出されます。 親ダイアログにメソッドが実装 ResumeDialogAsync されていない場合は、自動的に終了し、結果もその親に渡されます。 スタック上にそれ以上の親ダイアログがない場合、ターンの処理は終了します。

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)

パラメーター

result
Object

省略可能。結果は親コンテキストに渡されます。

cancellationToken
CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

実行するキューに登録された作業を表すタスク。

注釈

タスクが成功した場合、結果は、ダイアログによってターンが処理された後にダイアログが終了したことを示します。

一般に、親コンテキストは、ダイアログを開始したダイアログまたはボット ターン ハンドラーです。 親がダイアログの場合、スタックは親の ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) メソッドを呼び出して、結果を親ダイアログに返します。 親ダイアログに 'ResumeDialogAsync' が実装されていない場合、親も終了し、結果は次の親コンテキストに渡されます。

返される DialogTurnResult には、そのプロパティの戻り値が Result 含まれています。

適用対象

こちらもご覧ください