AttachmentInput class
提示用户发送文件的输入对话框。
- 扩展
构造函数
Attachment |
初始化 InputDialog 类的新实例 |
属性
$kind | |
output |
继承属性
allow |
中断策略。 |
always |
一个值,该值指示输入是否应始终提示用户,而不考虑是否存在值。 |
default |
超出 maxTurnCount 时输入对话框的默认值。 |
default |
达到 maxTurnCount 且使用默认值时要发送的活动模板。 |
disabled | 如果为 true,则为 true 的可选表达式将禁用此操作。 |
End |
获取默认的轮次结束结果。 |
id | |
invalid |
每当提供的值无效或无效时,要发送给用户的活动模板。 |
max |
在对话框放弃之前请求用户提供此值的最大次数。 |
OPTIONS_PROPERTY | |
prompt | 要发送给用户的活动。 |
property | 输入将绑定到的值表达式。 |
telemetry |
|
TURN_COUNT_PROPERTY | |
unrecognized |
用于重试提示的活动模板。 |
validations | 要运行的表达式用于验证输入。 |
value | 可用于初始化输入提示的值表达式。 |
VALUE_PROPERTY |
方法
get |
继承的方法
begin |
启动 对话框 并将其推送到对话堆栈时调用。 |
configure(Record<string, unknown>) | 用于配置对象的 Fluent 方法。 |
continue |
当 对话继续时调用,该对话是活动对话,用户使用新活动进行答复。 |
end |
在派生类中重写时,在对话结束之前执行清理。 |
get |
用于帮助在重新部署时检测机器人更改的编码字符串。 |
on |
通过使用当前对话或当前对话启动的对话,使用 |
reprompt |
在派生类中重写时,将用户重新分配输入。 |
resume |
子 对话框 完成轮次时调用,将控件返回到此对话。 |
构造函数详细信息
AttachmentInput(string, Partial<Activity> | string)
初始化 InputDialog 类的新实例
new AttachmentInput(property?: string, prompt?: Partial<Activity> | string)
参数
- property
-
string
自选。 输入将绑定到的值表达式。
- prompt
-
Partial<Activity> | string
自选。 要发送给用户的 活动,如果指定了字符串,它将实例化 ActivityTemplate。
属性详细信息
$kind
static $kind: string
属性值
string
outputFormat
继承属性详细信息
allowInterruptions
alwaysPrompt
一个值,该值指示输入是否应始终提示用户,而不考虑是否存在值。
alwaysPrompt: BoolExpression
属性值
BoolExpression
defaultValue
超出 maxTurnCount 时输入对话框的默认值。
defaultValue?: ValueExpression
属性值
ValueExpression
defaultValueResponse
达到 maxTurnCount 且使用默认值时要发送的活动模板。
defaultValueResponse: TemplateInterface<Partial<Activity>, DialogStateManager>
属性值
TemplateInterface<Partial<Activity>, DialogStateManager>
disabled
EndOfTurn
获取默认的轮次结束结果。
static EndOfTurn: DialogTurnResult
属性值
DialogTurnResult
注解
此结果指示对话(或对话中的逻辑步骤)已完成当前轮次的处理,仍然处于活动状态,并且正在等待更多输入。
继承自 Dialog.EndOfTurn
id
id: string
属性值
string
继承自 Dialog.id 的
invalidPrompt
每当提供的值无效或无效时,要发送给用户的活动模板。
invalidPrompt: TemplateInterface<Partial<Activity>, DialogStateManager>
属性值
TemplateInterface<Partial<Activity>, DialogStateManager>
maxTurnCount
OPTIONS_PROPERTY
static OPTIONS_PROPERTY: string
属性值
string
继承自
prompt
要发送给用户的活动。
prompt: TemplateInterface<Partial<Activity>, DialogStateManager>
属性值
TemplateInterface<Partial<Activity>, DialogStateManager>
property
telemetryClient
telemetryClient: BotTelemetryClient
属性值
BotTelemetryClient
继承自 Dialog.telemetryClient
TURN_COUNT_PROPERTY
static TURN_COUNT_PROPERTY: string
属性值
string
继承自
unrecognizedPrompt
用于重试提示的活动模板。
unrecognizedPrompt: TemplateInterface<Partial<Activity>, DialogStateManager>
属性值
TemplateInterface<Partial<Activity>, DialogStateManager>
validations
value
VALUE_PROPERTY
static VALUE_PROPERTY: string
属性值
string
继承自
方法详细信息
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
。
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
。
继承自
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
。
继承自