Freigeben über


ForEachPage class

Führt einen Satz von Aktionen einmal für jede Seite der Ergebnisse in einer Speicherliste oder -sammlung aus.

Extends

Hinweise

Die Liste oder Auflistung bei Eigenschaft wird in Seiten aufgeteilt und in dialog.page für jede Iteration der Schleife gespeichert. Die Größe jeder Seite wird durch maxSize- und standardmäßig auf eine Größe von 10 bestimmt. Die Schleife kann frühzeitig beendet werden, indem eine EndDialog- oder GotoDialog-Aktion eingeschlossen wird.

Konstruktoren

ForEachPage()

Eigenschaften

$kind
disabled

Ein optionaler Ausdruck, der bei "true" diese Aktion deaktiviert.

itemsProperty

Ausdruck, der zum Berechnen der Liste verwendet wird, die aufgezählt werden soll.

page

Ausdruck, der zum Berechnen der Liste verwendet wird, die aufgezählt werden soll.

pageIndex

Ausdruck, der zum Berechnen der Liste verwendet wird, die aufgezählt werden soll.

pageSize

Seitenformat, Standard 10.

Geerbte Eigenschaften

actions

Die auszuführenden Aktionen.

EndOfTurn

Ruft ein Standardmäßiges End-of-Turn-Ergebnis ab.

id
telemetryClient

Methoden

beginDialog(DialogContext, O)

Startet ein neues Dialog- und verschiebt es auf den Dialogstapel.

getConverter(Object)
getDependencies()

Ruft das untergeordnete Dialog Abhängigkeiten ab, damit sie den Containern Dialog festgelegt werden können.

Geerbte Methoden

configure(Record<string, unknown>)

Fluent-Methode zum Konfigurieren des Objekts.

continueDialog(DialogContext)

Wird aufgerufen, wenn das Dialog-fortgesetzt wird, wobei es sich um das aktive Dialogfeld handelt und der Benutzer mit einer neuen Aktivität antwortet.

endDialog(TurnContext, DialogInstance, DialogReason)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das Dialogfeld vor dem Beenden bereinigt.

getVersion()

Ruft eine eindeutige string, die die Version dieses Dialogfelds darstellt. Wenn sich die Version ändert, gibt das Dialogfeldsystem ein DialogChanged-Ereignis aus.

onDialogEvent(DialogContext, DialogEvent)

Wird aufgerufen, wenn ein Ereignis mit DialogContext.emitEvent()ausgelöst wurde, entweder durch das aktuelle Dialogfeld oder ein Dialogfeld, das das aktuelle Dialogfeld gestartet hat.

repromptDialog(TurnContext, DialogInstance)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Benutzer erneut zur Eingabe aufgefordert.

resumeDialog(DialogContext, DialogReason, any)

Wird aufgerufen, wenn ein untergeordnetes Dialog seine Drehung abgeschlossen hat, und gibt das Steuerelement zu diesem Dialogfeld zurück.

Details zum Konstruktor

ForEachPage()

new ForEachPage()

Details zur Eigenschaft

$kind

static $kind: string

Eigenschaftswert

string

disabled

Ein optionaler Ausdruck, der bei "true" diese Aktion deaktiviert.

disabled?: BoolExpression

Eigenschaftswert

BoolExpression

itemsProperty

Ausdruck, der zum Berechnen der Liste verwendet wird, die aufgezählt werden soll.

itemsProperty: StringExpression

Eigenschaftswert

StringExpression

page

Ausdruck, der zum Berechnen der Liste verwendet wird, die aufgezählt werden soll.

page: StringExpression

Eigenschaftswert

StringExpression

pageIndex

Ausdruck, der zum Berechnen der Liste verwendet wird, die aufgezählt werden soll.

pageIndex: StringExpression

Eigenschaftswert

StringExpression

pageSize

Seitenformat, Standard 10.

pageSize: IntExpression

Eigenschaftswert

IntExpression

Geerbte Eigenschaftsdetails

actions

Die auszuführenden Aktionen.

actions: Dialog[]

Eigenschaftswert

Dialog[]

vonActionScope.actions geerbt

EndOfTurn

Ruft ein Standardmäßiges End-of-Turn-Ergebnis ab.

static EndOfTurn: DialogTurnResult

Eigenschaftswert

DialogTurnResult

Hinweise

Dieses Ergebnis gibt an, dass ein Dialogfeld (oder ein logischer Schritt innerhalb eines Dialogfelds) die Verarbeitung für die aktuelle Drehung abgeschlossen hat, noch aktiv ist und auf weitere Eingaben wartet.

von Dialog.EndOfTurn geerbt

id

id: string

Eigenschaftswert

string

geerbt von Dialog.id

telemetryClient

telemetryClient: BotTelemetryClient

Eigenschaftswert

BotTelemetryClient

Geerbt von Dialog.telemetryClient

Details zur Methode

beginDialog(DialogContext, O)

Startet ein neues Dialog- und verschiebt es auf den Dialogstapel.

function beginDialog(dc: DialogContext, _options?: O): Promise<DialogTurnResult>

Parameter

dc

DialogContext

Die DialogContext- für die aktuelle Unterhaltungswende.

_options

O

Wahlfrei. Anfängliche Informationen, die an das Dialogfeld übergeben werden sollen.

Gibt zurück

Promise<DialogTurnResult>

Eine Promise, die den asynchronen Vorgang darstellt.

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

Parameter

property

Object

Der Schlüssel der Konfiguration der bedingten Auswahl.

Gibt zurück

Converter | ConverterFactory

Der Konverter für die Selektorkonfiguration.

getDependencies()

Ruft das untergeordnete Dialog Abhängigkeiten ab, damit sie den Containern Dialog festgelegt werden können.

function getDependencies(): Dialog[]

Gibt zurück

Dialog[]

Das untergeordnete Dialog Abhängigkeiten.

Details zur geerbten Methode

configure(Record<string, unknown>)

Fluent-Methode zum Konfigurieren des Objekts.

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

Parameter

config

Record<string, unknown>

Anzuwendende Konfigurationseinstellungen.

Gibt zurück

this

Die konfigurierbaren nach Abschluss des Vorgangs.

Geerbt von Konfigurierbar.configure

continueDialog(DialogContext)

Wird aufgerufen, wenn das Dialog-fortgesetzt wird, wobei es sich um das aktive Dialogfeld handelt und der Benutzer mit einer neuen Aktivität antwortet.

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

Parameter

dc

DialogContext

Die DialogContext- für die aktuelle Unterhaltungswende.

Gibt zurück

Promise<DialogTurnResult>

Eine Promise, die den asynchronen Vorgang darstellt.

VonActionScope.continueDialog geerbt

endDialog(TurnContext, DialogInstance, DialogReason)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das Dialogfeld vor dem Beenden bereinigt.

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

Parameter

_context

TurnContext

Das Kontextobjekt für die Drehung.

_instance

DialogInstance

Aktuelle Statusinformationen für dieses Dialogfeld.

_reason

DialogReason

Der Grund, warum das Dialogfeld beendet wird.

Gibt zurück

Promise<void>

Hinweise

Abgeleitete Dialogfelder, die vor dem Beenden Protokollierung oder Bereinigung durchführen müssen, sollten diese Methode überschreiben. Standardmäßig hat diese Methode keine Auswirkung.

Die DialogContext- ruft diese Methode auf, wenn das aktuelle Dialogfeld beendet wird.

Siehe auch

von Dialog.endDialog geerbt

getVersion()

Ruft eine eindeutige string, die die Version dieses Dialogfelds darstellt. Wenn sich die Version ändert, gibt das Dialogfeldsystem ein DialogChanged-Ereignis aus.

function getVersion(): string

Gibt zurück

string

Eindeutige string, die sich nur ändern sollte, wenn sich das Dialogfeld auf eine Weise geändert hat, die das Dialogfeld neu starten sollte.

Geerbt vonActionScope.getVersion

onDialogEvent(DialogContext, DialogEvent)

Wird aufgerufen, wenn ein Ereignis mit DialogContext.emitEvent()ausgelöst wurde, entweder durch das aktuelle Dialogfeld oder ein Dialogfeld, das das aktuelle Dialogfeld gestartet hat.

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

Parameter

dc

DialogContext

Der Dialogkontext für die aktuelle Unterhaltungswende.

e

DialogEvent

Das ausgelöste Ereignis.

Gibt zurück

Promise<boolean>

True, wenn das Ereignis vom aktuellen Dialogfeld behandelt wird und Bubbling beendet werden soll.

geerbt von Dialog.onDialogEvent

repromptDialog(TurnContext, DialogInstance)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Benutzer erneut zur Eingabe aufgefordert.

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

Parameter

_context

TurnContext

Das Kontextobjekt für die Drehung.

_instance

DialogInstance

Aktuelle Statusinformationen für dieses Dialogfeld.

Gibt zurück

Promise<void>

Hinweise

Abgeleitete Dialogfelder, die validierungs- und erneute Aufforderungslogik unterstützen, sollten diese Methode überschreiben. Standardmäßig hat diese Methode keine Auswirkung.

Die DialogContext- ruft diese Methode auf, wenn das aktuelle Dialogfeld eingaben vom Benutzer erneut anfordern soll. Diese Methode wird für Eingabeaufforderungsdialoge implementiert.

Siehe auch

geerbt von Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

Wird aufgerufen, wenn ein untergeordnetes Dialog seine Drehung abgeschlossen hat, und gibt das Steuerelement zu diesem Dialogfeld zurück.

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

Parameter

dc

DialogContext

Die DialogContext- für die aktuelle Unterhaltungswende.

_reason

DialogReason

(xref:botbuilder-dialogs. DialogReason), Grund, warum das Dialogfeld fortgesetzt wurde.

result

any

Wahlfrei. Der wert, der aus dem aufgerufenen Dialogfeld zurückgegeben wurde. Der Typ des zurückgegebenen Werts hängt vom untergeordneten Dialogfeld ab.

Gibt zurück

Promise<DialogTurnResult>

Eine Promise, die den asynchronen Vorgang darstellt.

Geerbt vonActionScope.resumeDialog