DialogContext Klasse

Referenz

Definition

Namespace:: Microsoft.Bot.Builder.Dialogs

Assembly:: Microsoft.Bot.Builder.Dialogs.dll

Paket:: Microsoft.Bot.Builder.Dialogs v4.18.1

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.

Stellt Kontext für den aktuellen Status des Dialogstapels bereit.

public class DialogContext

type DialogContext = class

Public Class DialogContext

Vererbung: Object
DialogContext

Abgeleitet: Microsoft.Bot.Builder.Dialogs.Adaptive.ActionContext

Microsoft.Bot.Builder.Dialogs.WaterfallStepContext

Hinweise

Die Context -Eigenschaft enthält den ITurnContext für den aktuellen Turn.

Konstruktoren

DialogContext(DialogSet, DialogContext, DialogState)	Initialisiert eine neue Instanz der DialogContext-Klasse.
DialogContext(DialogSet, ITurnContext, DialogState)	Initialisiert eine neue Instanz der DialogContext -Klasse aus dem Turnkontext.

Eigenschaften

ActiveDialog	Ruft die zwischengespeicherte Instanz des aktiven Dialogfelds am oberen Rand des Stapels ab oder `null` wenn der Stapel leer ist.
Child	Ruft den Dialogkontext für untergeordnete Elemente ab, wenn ein aktives untergeordnetes Element vorhanden ist.
Context	Ruft den Kontext für den aktuellen Unterhaltungswechsel ab.
DialogManager	Veraltet. Ruft den aktuellen DialogManager für diesen DialogContext ab. Diese Eigenschaft ist veraltet.
Dialogs	Ruft die Gruppe von Dialogfeldern ab, die für den aktuellen Dialogcontainer aktiv sind.
Parent	Ruft das übergeordnete DialogContextElement ab, falls vorhanden, oder legt dieses fest. Wird bei der Suche nach der ID eines zu startenden Dialogfelds verwendet.
Services	Ruft die Dienstesammlung ab, die für diesen Dialogkontext kontextbezogen ist.
Stack	Ruft den aktuellen Dialogstapel ab.
State	Ruft den DialogStateManager ab, der die Ansicht aller Speicherbereiche verwaltet, oder legt diese fest.

Methoden

BeginDialogAsync(String, Object, CancellationToken)	Startet einen neuen Dialog und legt ihn auf dem Dialogstapel ab.
CancelAllDialogsAsync(Boolean, String, Object, CancellationToken)	Löscht alle vorhandenen Dialogstapel, wodurch alle Dialoge auf dem Stapel abgebrochen werden.
CancelAllDialogsAsync(CancellationToken)	Löscht alle vorhandenen Dialogstapel, wodurch alle Dialoge auf dem Stapel abgebrochen werden.
ContinueDialogAsync(CancellationToken)	Setzt die Ausführung des aktiven Dialogfelds fort, falls vorhanden, durch Übergeben des aktuellen DialogContext an die Methode des aktiven Dialogs ContinueDialogAsync(DialogContext, CancellationToken) .
EmitEventAsync(String, Object, Boolean, Boolean, CancellationToken)	Sucht nach einem Dialogfeld mit einer angegebenen ID. Gibt ein benanntes Ereignis für das aktuelle Dialogfeld oder eine Person aus, die es gestartet hat, um es zu behandeln.
EndDialogAsync(Object, CancellationToken)	Beendet ein Dialogfeld, indem es aus dem Stapel geknallt wird, und gibt ein optionales Ergebnis an das übergeordnete Dialogfeld zurück. Das übergeordnete Dialogfeld ist das Dialogfeld, das über einen Aufruf von oder BeginDialogAsync(String, Object, CancellationToken)PromptAsync(String, PromptOptions, CancellationToken)beendet wird. Im übergeordneten Dialogfeld wird die ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) -Methode mit jedem zurückgegebenen Ergebnis aufgerufen. Wenn das übergeordnete Dialogfeld keine `ResumeDialogAsync` Methode implementiert hat, wird sie automatisch beendet und das Ergebnis an das übergeordnete Element übergeben. Wenn keine übergeordneten Dialoge mehr auf dem Stapel vorhanden sind, wird die Verarbeitung des Drehs beendet.
FindDialog(String)	Suchen Sie die Dialog-ID für den angegebenen Kontext.
GetLocale()	Rufen Sie die CultureInfo in DialogContext ab.
PromptAsync(String, PromptOptions, CancellationToken)	Hilfsfunktion, um die Formatierung der Optionen zum Aufrufen eines Eingabeaufforderungsdialogfelds zu vereinfachen. Dieses Hilfsprogramm akzeptiert ein `options` Argument und ruft dann auf BeginDialogAsync(String, Object, CancellationToken).
ReplaceDialogAsync(String, Object, CancellationToken)	Startet einen neuen Dialog und ersetzt den derzeit aktiven Dialog auf dem Stapel durch den neuen. Dies ist besonders nützlich, um Schleifen zu erstellen oder zu einem anderen Dialogfeld umzuleiten.
RepromptDialogAsync(CancellationToken)	Ruft die Methode des aktuell aktiven Dialogfelds RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) auf. Wird mit Dialogfeldern verwendet, die ein Erneutes Eingabeaufforderungsverhalten implementieren.

Erweiterungsmethoden

DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)	Rufen Sie den aktiven IDialogDebugger an, und teilen Sie ihm mit, dass wir uns an einem bestimmten Punkt befinden.
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)	Rufen Sie den aktiven IDialogDebugger auf, und teilen Sie ihm mit, dass wir uns an einem bestimmten Punkt im Dialog befinden.
DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)	Rufen Sie den aktiven IDialogDebugger auf, und lassen Sie ihn wissen, dass wir uns an einem bestimmten Punkt in der Erkennung befinden.
DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)	Rufen Sie den aktiven IDialogDebugger auf, und lassen Sie ihn wissen, dass wir uns an einem bestimmten Punkt in der Erkennung befinden.
GetDebugger(DialogContext)	Erweiterungsmethode zum Abrufen von IDialogDebugger aus DialogContext.

Gilt für: