WaterfallDialog Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dialogfeld, das für die Aufforderung eines Benutzers mit einer Reihe von Fragen optimiert ist. Wasserfälle akzeptieren einen Stapel von Funktionen, die in Folge ausgeführt werden. Jeder Wasserfallschritt kann eine Frage des Benutzers stellen, und die Antwort des Benutzers wird als Argument an den nächsten Wasserfallschritt übergeben.
public class WaterfallDialog : Microsoft.Bot.Builder.Dialogs.Dialog
type WaterfallDialog = class
inherit Dialog
Public Class WaterfallDialog
Inherits Dialog
- Vererbung
- Abgeleitet
Konstruktoren
| Name | Beschreibung |
|---|---|
| WaterfallDialog(String, IEnumerable<WaterfallStep>) |
Initialisiert eine neue Instanz der WaterfallDialog-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Id |
Erhält oder setzt eine ID für den Dialog. (Geerbt von Dialog) |
| Source |
Erhält die Information des Cref="SourceRange"/>. (Geerbt von Dialog) |
| TelemetryClient |
Es bekommt oder setzt die Nutzung IBotTelemetryClient , um sie für das Protokollieren zu verwenden. (Geerbt von Dialog) |
Methoden
| Name | Beschreibung |
|---|---|
| AddStep(WaterfallStep) |
Fügt dem Wasserfall einen neuen Schritt hinzu. |
| BeginDialogAsync(DialogContext, Object, CancellationToken) |
Wird aufgerufen, wenn das Wasserfalldialogfeld gestartet und auf den Dialogstapel verschoben wird. |
| ContinueDialogAsync(DialogContext, CancellationToken) |
Wird aufgerufen, wenn der Wasserfall-Dialog fortgesetzt wird, wo es der aktive Dialog ist und der Benutzer mit einer neuen Aktivität antwortet. |
| EndDialogAsync(ITurnContext, DialogInstance, DialogReason, CancellationToken) |
Wird aufgerufen, wenn das Dialogfeld beendet wird. |
| GetVersion() |
Erhält eine eindeutige Zeichenkette, die die Version dieses Dialogs darstellt. Wenn sich die Version ändert, gibt das Dialogfeldsystem ein DialogChanged-Ereignis aus. |
| OnComputeId() |
Erstellt die Compute-ID für den Dialog. (Geerbt von Dialog) |
| OnDialogEventAsync(DialogContext, DialogEvent, CancellationToken) |
Wird aufgerufen, wenn ein Ereignis mit |
| OnPostBubbleEventAsync(DialogContext, DialogEvent, CancellationToken) |
Wird aufgerufen, nachdem ein Ereignis für alle übergeordneten Eltern eingeblasen wurde und nicht behandelt wurde. (Geerbt von Dialog) |
| OnPreBubbleEventAsync(DialogContext, DialogEvent, CancellationToken) |
Wird aufgerufen, bevor ein Ereignis in das übergeordnete Element eingeblasen wird. (Geerbt von Dialog) |
| OnStepAsync(WaterfallStepContext, CancellationToken) |
Wird aufgerufen, wenn ein einzelner Wasserfallschritt ausgeführt wird. |
| RegisterSourceLocation(String, Int32) |
Registriert ein Cref="SourceRange"/> an der angegebenen Stelle. (Geerbt von Dialog) |
| RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) |
Wird aufgerufen, wenn das Dialogfeld den Benutzer zur Eingabe erneut auffordert. (Geerbt von Dialog) |
| ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) |
Wird aufgerufen, wenn ein untergeordnetes Wasserfalldialogfeld seine Drehung abgeschlossen hat, und gibt das Steuerelement zu diesem Dialogfeld zurück. |
| RunStepAsync(DialogContext, Int32, DialogReason, Object, CancellationToken) |
Erregt einen Schritt des Wasserfalldialogs. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| RunAsync(Dialog, ITurnContext, IStatePropertyAccessor<DialogState>, CancellationToken) |
Erstellt einen Dialogstapel und startet ein Dialogfeld, indem es auf den Stapel verschoben wird. |