語言

DialogContext 類別

定義

提供對話框堆疊目前狀態的內容。

public class DialogContext
type DialogContext = class
Public Class DialogContext
繼承
DialogContext
衍生

備註

Context 屬性包含目前回合的 ITurnContext。

建構函式

名稱 Description
DialogContext(DialogSet, DialogContext, DialogState)

初始化 DialogContext 類別的新執行個體。

DialogContext(DialogSet, ITurnContext, DialogState)

從回合上下文初始化該 DialogContext 類別的新實例。

屬性

名稱 Description
ActiveDialog

會取得目前活躍對話框的快取實例,置於堆疊頂端或 null 堆疊為空時。

Child

如果有作用中的子系,則取得子系的對話內容。

Context

取得目前交談回合的內容。

DialogManager
已淘汰.

取得此對話上下文目前的 DialogManager。 這個屬性已過時。

Dialogs

取得目前對話容器作用中的對話框集合。

Parent

如果有的話,他會取得或設定父本 DialogContext。 用於搜尋要啟動之對話框的標識碼。

Services

取得與這個對話內容相關的服務集合。

Stack

取得目前的對話框堆疊。

State

取得或設定 DialogStateManager,可管理所有記憶體範圍的檢視。

方法

名稱 Description
BeginDialogAsync(String, Object, CancellationToken)

啟動新的對話框,並將其推送至對話堆疊。

CancelAllDialogsAsync(Boolean, String, Object, CancellationToken)

刪除任何現有的對話堆疊,因此會取消堆疊上的所有對話方塊。

CancelAllDialogsAsync(CancellationToken)

刪除任何現有的對話堆疊,因此會取消堆疊上的所有對話方塊。

ContinueDialogAsync(CancellationToken)

如果有活躍對話框,繼續執行,方法是將電流 DialogContext 傳遞給該主動對話 ContinueDialogAsync(DialogContext, CancellationToken) 的方法。

EmitEventAsync(String, Object, Boolean, Boolean, CancellationToken)

搜尋具有指定標識碼的對話框。 針對目前對話框或啟動該對話框的人員發出具名事件來處理。

EndDialogAsync(Object, CancellationToken)

結束對話的方式是將對話框從堆疊中彈出,並將選擇性結果傳回給對話框的父代。 父對話是透過呼叫 BeginDialogAsync(String, Object, CancellationToken) 或 PromptAsync(String, PromptOptions, CancellationToken)結束的 對話框。 父對話框會使用任何傳回的結果叫用其 ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) 方法。 如果父對話框尚未實作 ResumeDialogAsync 方法,則它也會自動結束,並將結果傳遞至其父系。 如果堆疊上沒有更多父對話框,回合的處理將會結束。

FindDialog(String)

尋找指定內容的對話框識別碼。

GetLocale()

取得 DialogContext 中的 CultureInfo。

PromptAsync(String, PromptOptions, CancellationToken)

協助程式函式可簡化呼叫提示對話框之選項的格式設定。 這位助手會接受 options 爭論後,再打電話 BeginDialogAsync(String, Object, CancellationToken)給 。

ReplaceDialogAsync(String, Object, CancellationToken)

啟動新的對話框,並以新的對話框取代目前使用中的對話框堆棧。 這對於建立迴圈或重新導向至另一個對話框特別有用。

RepromptDialogAsync(CancellationToken)

呼叫目前使用中對話框的 RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) 方法。 與實作重新提示行為的對話框搭配使用。

擴充方法

名稱 Description
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)

呼叫啟用的 IDialogDebugger,讓它知道我們已經在對話框的指定位置。

DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)

呼叫啟用的 IDialogDebugger,告訴它我們在 Recognizer 的指定位置。

DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)

呼叫啟用的 IDialogDebugger,讓它知道我們已經到達指定位置。

DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)

呼叫啟用的 IDialogDebugger,告訴它我們在 Recognizer 的指定位置。

GetDebugger(DialogContext)

從 DialogContext 取得 IDialogDebugger 的擴充方法。

適用於