DialogContext 類別

定義

命名空間:

Microsoft.Bot.Builder.Dialogs

組件:

Microsoft.Bot.Builder.Dialogs.dll

套件:

Microsoft.Bot.Builder.Dialogs v4.22.7

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

public class DialogContext

type DialogContext = class

Public Class DialogContext

繼承

Object

DialogContext

衍生

Microsoft.Bot.Builder.Dialogs.Adaptive.ActionContext

Microsoft.Bot.Builder.Dialogs.WaterfallStepContext

備註

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

建構函式

DialogContext(DialogSet, DialogContext, DialogState)	初始化 DialogContext 類別的新執行個體。
DialogContext(DialogSet, ITurnContext, DialogState)	從回合內容初始化 類別的新實例 DialogContext 。

屬性

ActiveDialog	取得堆疊頂端作用中對話方塊的快取實例，如果 null 堆疊是空的，則為 。
Child	如果有作用中的子系，取得子系的對話方塊內容。
Context	取得目前交談回合的內容。
DialogManager	已淘汰. 取得這個 dialogCoNtext 的目前 DialogManager。 這個屬性已經過時。
Dialogs	取得目前對話容器作用中的對話方塊集合。
Parent	取得或設定父 DialogContext 系 ，如果有的話。 用於搜尋要啟動之對話方塊的識別碼。
Services	取得與這個對話內容相關的服務集合。
Stack	取得目前的對話方塊堆疊。
State	取得或設定 DialogStateManager，其可管理所有記憶體範圍的檢視。

方法

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)	結束對話的方式是將它從堆疊取出，並將選擇性的結果傳回給對話方塊的父代。 父對話方塊是透過 或 PromptAsync(String, PromptOptions, CancellationToken) 呼叫 BeginDialogAsync(String, Object, 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) 對話方塊方法。 與實作重新提示行為的對話方塊搭配使用。

擴充方法

DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)	呼叫使用中的 IDialogDebugger，並讓它知道我們在指定的時間點。
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)	呼叫使用中的 IDialogDebugger，並讓它知道我們在對話方塊中的指定點。
DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)	呼叫使用中的 IDialogDebugger，並讓它知道我們在辨識器中的指定點。
DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)	呼叫使用中的 IDialogDebugger，並讓它知道我們在辨識器中的指定點。
GetDebugger(DialogContext)	從 DialogCoNtext 取得 IDialogDebugger 的擴充方法。