DialogContext 类

定义

提供对话堆栈的当前状态的上下文。

public class DialogContext
type DialogContext = class
Public Class DialogContext
继承
DialogContext
派生

注解

Context 属性包含当前轮次的 ITurnContext

构造函数

名称 说明
DialogContext(DialogSet, DialogContext, DialogState)

初始化 DialogContext 类的新实例。

DialogContext(DialogSet, ITurnContext, DialogState)

从回合上下文中初始化该 DialogContext 类的新实例。

属性

名称 说明
ActiveDialog

获取当前对话的缓存实例,位于栈顶端,或者 null 栈为空时。

Child

获取子级的对话上下文(如果有活动子级)。

Context

获取当前会话轮次的上下文。

DialogManager
已过时.

获取当前的 DialogManager 来处理这个 dialogContext。 此属性已过时。

Dialogs

获取当前对话容器处于活动状态的对话框集。

Parent

获得或设定父节点 DialogContext(如果有的话)。 搜索要启动的对话的 ID 时使用。

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)

搜索具有给定 ID 的对话框。 为当前对话框或启动该对话框的人员发出命名事件进行处理。

EndDialogAsync(Object, CancellationToken)

通过从堆栈中弹出对话来结束对话,并将可选结果返回给对话框的父级。 父对话是启动的对话框,通过调用 BeginDialogAsync(String, Object, CancellationToken)PromptAsync(String, PromptOptions, CancellationToken)结束。 父对话将使用任何返回的结果调用其 ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) 方法。 如果父对话尚未实现 ResumeDialogAsync 方法,则它也会自动结束,并将结果传递给其父级。 如果堆栈上没有更多父对话,则轮次处理将结束。

FindDialog(String)

查找给定上下文的对话框 ID。

GetLocale()

在 DialogContext 中获取 CultureInfo。

PromptAsync(String, PromptOptions, CancellationToken)

帮助程序函数,用于简化用于调用提示对话框的选项的格式设置。 这个助手会先争论 options ,然后叫 BeginDialogAsync(String, Object, CancellationToken)

ReplaceDialogAsync(String, Object, CancellationToken)

启动一个新对话框,并将当前活动对话替换为新对话的堆栈。 这对于创建循环或重定向到另一个对话特别有用。

RepromptDialogAsync(CancellationToken)

调用当前活动对话框的 RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) 方法。 与实现重新提示行为的对话框一起使用。

扩展方法

名称 说明
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)

调用active的IDialogDebugger,告诉它我们处于对话框的指定位置。

DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)

调用active的IDialogDebugger,告诉它我们在Recognizer的指定位置。

DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)

调用active的IDialogDebugger,告诉它我们已经到达了给定的节点。

DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)

调用active的IDialogDebugger,告诉它我们在Recognizer的指定位置。

GetDebugger(DialogContext)

从 DialogContext 获取 IDialogDebugger 的扩展方法。

适用于