DateTimeInput class

用于从用户收集日期/时间的输入对话框。

扩展

构造函数

DateTimeInput(string, Partial<Activity> | string)

初始化 InputDialog 类的新实例

属性

$kind
defaultLocale
outputFormat

继承属性

allowInterruptions

中断策略。

alwaysPrompt

一个值,该值指示输入是否应始终提示用户,而不考虑是否存在值。

defaultValue

超出 maxTurnCount 时输入对话框的默认值。

defaultValueResponse

达到 maxTurnCount 且使用默认值时要发送的活动模板。

disabled

如果为 true,则为 true 的可选表达式将禁用此操作。

EndOfTurn

获取默认的轮次结束结果。

id
invalidPrompt

每当提供的值无效或无效时,要发送给用户的活动模板。

maxTurnCount

在对话框放弃之前请求用户提供此值的最大次数。

OPTIONS_PROPERTY
prompt

要发送给用户的活动。

property

输入将绑定到的值表达式。

telemetryClient
TURN_COUNT_PROPERTY
unrecognizedPrompt

用于重试提示的活动模板。

validations

要运行的表达式用于验证输入。

value

可用于初始化输入提示的值表达式。

VALUE_PROPERTY

方法

getConverter(Object)

继承的方法

beginDialog(DialogContext, any)

启动 对话框 并将其推送到对话堆栈时调用。

configure(Record<string, unknown>)

用于配置对象的 Fluent 方法。

continueDialog(DialogContext)

对话继续时调用,该对话是活动对话,用户使用新活动进行答复。

endDialog(TurnContext, DialogInstance, DialogReason)

在派生类中重写时,在对话结束之前执行清理。

getVersion()

用于帮助在重新部署时检测机器人更改的编码字符串。

onDialogEvent(DialogContext, DialogEvent)

通过使用当前对话或当前对话启动的对话,使用 DialogContext.emitEvent()引发事件时调用。

repromptDialog(TurnContext, DialogInstance)

在派生类中重写时,将用户重新分配输入。

resumeDialog(DialogContext, DialogReason, any)

对话框 完成轮次时调用,将控件返回到此对话。

构造函数详细信息

DateTimeInput(string, Partial<Activity> | string)

初始化 InputDialog 类的新实例

new DateTimeInput(property?: string, prompt?: Partial<Activity> | string)

参数

property

string

自选。 输入将绑定到的值表达式。

prompt

Partial<Activity> | string

自选。 要发送给用户的 活动,如果指定了字符串,它将实例化 ActivityTemplate

属性详细信息

$kind

static $kind: string

属性值

string

defaultLocale

defaultLocale: StringExpression

属性值

StringExpression

outputFormat

outputFormat: StringExpression

属性值

StringExpression

继承属性详细信息

allowInterruptions

中断策略。

allowInterruptions: BoolExpression

属性值

BoolExpression

继承自InputDialog.allowInterruptions

alwaysPrompt

一个值,该值指示输入是否应始终提示用户,而不考虑是否存在值。

alwaysPrompt: BoolExpression

属性值

BoolExpression

继承自InputDialog.alwaysPrompt

defaultValue

超出 maxTurnCount 时输入对话框的默认值。

defaultValue?: ValueExpression

属性值

ValueExpression

继承自InputDialog.defaultValue

defaultValueResponse

达到 maxTurnCount 且使用默认值时要发送的活动模板。

defaultValueResponse: TemplateInterface<Partial<Activity>, DialogStateManager>

属性值

TemplateInterface<Partial<Activity>, DialogStateManager>

继承自InputDialog.defaultValueResponse

disabled

如果为 true,则为 true 的可选表达式将禁用此操作。

disabled?: BoolExpression

属性值

BoolExpression

继承自InputDialog.disabled

EndOfTurn

获取默认的轮次结束结果。

static EndOfTurn: DialogTurnResult

属性值

DialogTurnResult

注解

此结果指示对话(或对话中的逻辑步骤)已完成当前轮次的处理,仍然处于活动状态,并且正在等待更多输入。

继承自 Dialog.EndOfTurn

id

id: string

属性值

string

继承自 Dialog.id 的

invalidPrompt

每当提供的值无效或无效时,要发送给用户的活动模板。

invalidPrompt: TemplateInterface<Partial<Activity>, DialogStateManager>

属性值

TemplateInterface<Partial<Activity>, DialogStateManager>

继承自InputDialog.invalidPrompt

maxTurnCount

在对话框放弃之前请求用户提供此值的最大次数。

maxTurnCount?: IntExpression

属性值

IntExpression

继承自InputDialog.maxTurnCount

OPTIONS_PROPERTY

static OPTIONS_PROPERTY: string

属性值

string

继承自InputDialog.OPTIONS_PROPERTY

prompt

要发送给用户的活动。

prompt: TemplateInterface<Partial<Activity>, DialogStateManager>

属性值

TemplateInterface<Partial<Activity>, DialogStateManager>

继承自InputDialog.prompt

property

输入将绑定到的值表达式。

property: StringExpression

属性值

StringExpression

继承自InputDialog.property

telemetryClient

telemetryClient: BotTelemetryClient

属性值

BotTelemetryClient

继承自 Dialog.telemetryClient

TURN_COUNT_PROPERTY

static TURN_COUNT_PROPERTY: string

属性值

string

继承自InputDialog.TURN_COUNT_PROPERTY

unrecognizedPrompt

用于重试提示的活动模板。

unrecognizedPrompt: TemplateInterface<Partial<Activity>, DialogStateManager>

属性值

TemplateInterface<Partial<Activity>, DialogStateManager>

继承自InputDialog.unrecognizedPrompt

validations

要运行的表达式用于验证输入。

validations: string[]

属性值

string[]

继承自InputDialog.validations

value

可用于初始化输入提示的值表达式。

value: ValueExpression

属性值

ValueExpression

继承自InputDialog.value

VALUE_PROPERTY

static VALUE_PROPERTY: string

属性值

string

继承自InputDialog.VALUE_PROPERTY

方法详细信息

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

参数

property

Object

条件选择器配置的键。

返回

Converter | ConverterFactory

选择器配置的转换器。

继承的方法详细信息

beginDialog(DialogContext, any)

启动 对话框 并将其推送到对话堆栈时调用。

function beginDialog(dc: DialogContext, options?: any): Promise<DialogTurnResult>

参数

dc

DialogContext

当前会话轮次的 DialogContext

options

any

自选。 要传递给 对话框的初始信息

返回

Promise<DialogTurnResult>

表示异步操作的 DialogTurnResultPromise

继承自InputDialog.beginDialog

configure(Record<string, unknown>)

用于配置对象的 Fluent 方法。

function configure(config: Record<string, unknown>): this

参数

config

Record<string, unknown>

要应用的配置设置。

返回

this

操作完成后 可配置

继承自 Configure.configure

continueDialog(DialogContext)

对话继续时调用,该对话是活动对话,用户使用新活动进行答复。

function continueDialog(dc: DialogContext): Promise<DialogTurnResult>

参数

dc

DialogContext

当前会话轮次的 DialogContext

返回

Promise<DialogTurnResult>

表示异步操作的 DialogTurnResultPromise

继承自InputDialog.continueDialog

endDialog(TurnContext, DialogInstance, DialogReason)

在派生类中重写时,在对话结束之前执行清理。

function endDialog(_context: TurnContext, _instance: DialogInstance, _reason: DialogReason): Promise<void>

参数

_context

TurnContext

轮次的上下文对象。

_instance

DialogInstance

此对话框的当前状态信息。

_reason

DialogReason

对话结束的原因。

返回

Promise<void>

注解

在结束之前需要执行日志记录或清理的派生对话应重写此方法。 默认情况下,此方法不起作用。

当当前对话结束时,DialogContext 调用此方法。

另请参阅

继承自 Dialog.endDialog

getVersion()

用于帮助在重新部署时检测机器人更改的编码字符串。

function getVersion(): string

返回

string

唯一字符串,仅当对话发生更改时,才应以重启对话框的方式更改。

注解

这默认返回对话 ID,但可以重写以提供更精确的更改检测逻辑。 堆栈上具有其版本更改的任何对话框都将导致引发 versionChanged 事件。 如果机器人未处理此事件,将引发错误,从而导致运行机器人错误处理程序逻辑。

返回空字符串将一起禁用组件的版本跟踪。

继承自 Dialog.getVersion

onDialogEvent(DialogContext, DialogEvent)

通过使用当前对话或当前对话启动的对话,使用 DialogContext.emitEvent()引发事件时调用。

function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>

参数

dc

DialogContext

当前对话轮次的对话上下文。

e

DialogEvent

正在引发的事件。

返回

Promise<boolean>

如此 如果事件由当前对话框处理,并且冒泡应停止。

继承自 Dialog.onDialogEvent

repromptDialog(TurnContext, DialogInstance)

在派生类中重写时,将用户重新分配输入。

function repromptDialog(_context: TurnContext, _instance: DialogInstance): Promise<void>

参数

_context

TurnContext

轮次的上下文对象。

_instance

DialogInstance

此对话框的当前状态信息。

返回

Promise<void>

注解

支持验证和重新提示逻辑的派生对话应重写此方法。 默认情况下,此方法不起作用。

DialogContext 在当前对话应从用户重新请求输入时调用此方法。 此方法是针对提示对话实现的。

另请参阅

继承自 Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

对话框 完成轮次时调用,将控件返回到此对话。

function resumeDialog(dc: DialogContext, _reason: DialogReason, _result?: any): Promise<DialogTurnResult>

参数

dc

DialogContext

当前会话轮次的 DialogContext

_reason

DialogReason

(xref:botbuilder-dialogs.DialogReason),对话恢复的原因。

_result

any

自选。 从调用的 对话框 返回的值。 返回的值的类型取决于子对话。

返回

Promise<DialogTurnResult>

表示异步操作的 DialogTurnResultPromise

继承自InputDialog.resumeDialog