ForEachPage class
Выполняет набор действий один раз для каждой страницы результатов в списке или коллекции в памяти.
- Extends
-
ActionScope<O>
Комментарии
Список или коллекция в свойстве будут разбиты на страницы и хранятся в dialog.page для каждой итерации цикла. Размер каждой страницы определяется maxSize и по умолчанию имеет размер 10. Цикл можно завершить рано, включив действие EndDialog или GotoDialog.
Конструкторы
| For |
Свойства
| $kind | |
| disabled | Необязательное выражение, которое, если задано значение true, отключит это действие. |
| items |
Выражение, используемое для вычисления списка, который следует перечислить. |
| page | Выражение, используемое для вычисления списка, который следует перечислить. |
| page |
Выражение, используемое для вычисления списка, который следует перечислить. |
| page |
Размер страницы по умолчанию — 10. |
Унаследованные свойства
| actions | Выполняемые действия. |
| End |
Возвращает результат конца по умолчанию. |
| id | |
| telemetry |
Методы
| begin |
|
| get |
|
| get |
Получает дочерни |
Наследуемые методы
| configure(Record<string, unknown>) | Метод Fluent для настройки объекта. |
| continue |
Вызывается, когда диалогового окна |
| end |
При переопределении в производном классе выполняет очистку диалогового окна перед завершением. |
| get |
Возвращает уникальный |
| on |
Вызывается при возникновении события, используя |
| reprompt |
При переопределении в производном классе переиздает пользователя для ввода. |
| resume |
Вызывается, когда дочерний диалог завершил свою очередь, возвращая элемент управления в это диалоговое окно. |
Сведения о конструкторе
ForEachPage()
new ForEachPage()
Сведения о свойстве
$kind
static $kind: string
Значение свойства
string
disabled
Необязательное выражение, которое, если задано значение true, отключит это действие.
disabled?: BoolExpression
Значение свойства
BoolExpression
itemsProperty
Выражение, используемое для вычисления списка, который следует перечислить.
itemsProperty: StringExpression
Значение свойства
StringExpression
page
Выражение, используемое для вычисления списка, который следует перечислить.
page: StringExpression
Значение свойства
StringExpression
pageIndex
Выражение, используемое для вычисления списка, который следует перечислить.
pageIndex: StringExpression
Значение свойства
StringExpression
pageSize
Размер страницы по умолчанию — 10.
pageSize: IntExpression
Значение свойства
IntExpression
Сведения об унаследованном свойстве
actions
Выполняемые действия.
actions: Dialog[]
Значение свойства
Dialog[]
наследуется отActionScope.actions
EndOfTurn
Возвращает результат конца по умолчанию.
static EndOfTurn: DialogTurnResult
Значение свойства
DialogTurnResult
Комментарии
Этот результат указывает, что диалоговое окно (или логический шаг в диалоговом окне) завершило обработку текущего шага, по-прежнему активно и ожидает дополнительных входных данных.
унаследован от диалогового окна.EndOfTurn
id
id: string
Значение свойства
string
унаследован от Dialog.id
telemetryClient
telemetryClient: BotTelemetryClient
Значение свойства
BotTelemetryClient
наследуется от Dialog.telemetryClient
Сведения о методе
beginDialog(DialogContext, O)
Запускает новый диалог и отправляет его в стек диалогов.
function beginDialog(dc: DialogContext, _options?: O): Promise<DialogTurnResult>
Параметры
- dc
-
DialogContext
DialogContext для текущей очереди беседы.
- _options
-
O
Необязательный. Начальные сведения для передачи в диалоговое окно.
Возвращаемое значение
Promise<DialogTurnResult>
Promise, представляющий асинхронную операцию.
getConverter(Object)
function getConverter(property: Object): Converter | ConverterFactory
Параметры
- property
-
Object
Ключ конфигурации условного селектора.
Возвращаемое значение
Converter | ConverterFactory
Преобразователь конфигурации селектора.
getDependencies()
Получает дочерни
function getDependencies(): Dialog[]
Возвращаемое значение
Dialog[]
Сведения о наследуемом методе
configure(Record<string, unknown>)
Метод Fluent для настройки объекта.
function configure(config: Record<string, unknown>): this
Параметры
- config
-
Record<string, unknown>
Параметры конфигурации для применения.
Возвращаемое значение
this
После завершения операции настраиваемый.
наследуется от Configurable.configure
continueDialog(DialogContext)
Вызывается, когда диалогового окна
function continueDialog(dc: DialogContext): Promise<DialogTurnResult>
Параметры
- dc
-
DialogContext
DialogContext для текущей очереди беседы.
Возвращаемое значение
Promise<DialogTurnResult>
Promise, представляющий асинхронную операцию.
унаследовано отActionScope.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()
Возвращает уникальный string, представляющий версию этого диалогового окна. Если изменение версии между поворотами диалоговой системы приведет к возникновению события DialogChanged.
function getVersion(): string
Возвращаемое значение
string
Уникальный string, который должен изменяться только при изменении диалогового окна таким образом, чтобы перезапустить диалоговое окно.
унаследован отActionScope.getVersion
onDialogEvent(DialogContext, DialogEvent)
Вызывается при возникновении события, используя DialogContext.emitEvent(), текущим диалогом или диалогом, запущенным текущим диалогом.
function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>
Параметры
- dc
-
DialogContext
Контекст диалогового окна для текущей очереди беседы.
- e
-
DialogEvent
Возникает событие.
Возвращаемое значение
Promise<boolean>
Значение True, если событие обрабатывается текущим диалогом, а пузырьк должен остановиться.
унаследован от диалогового окна.onDialogEvent
repromptDialog(TurnContext, DialogInstance)
При переопределении в производном классе переиздает пользователя для ввода.
function repromptDialog(_context: TurnContext, _instance: DialogInstance): Promise<void>
Параметры
- _context
-
TurnContext
Объект контекста для поворота.
- _instance
-
DialogInstance
Текущие сведения о состоянии для этого диалогового окна.
Возвращаемое значение
Promise<void>
Комментарии
Производные диалоги, поддерживающие проверку и логику повторного запроса, должны переопределить этот метод. По умолчанию этот метод не действует.
DialogContext вызывает этот метод, когда текущее диалоговое окно должно повторно запрашивать входные данные от пользователя. Этот метод реализуется для диалоговых окон запроса.
См. также
унаследован от диалогового окна "Диалоговое окно.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>
Promise, представляющий асинхронную операцию.
унаследован отActionScope.resumeDialog