DialogContext Klasse

Definition

Namespace:: Microsoft.Bot.Builder.Dialogs

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

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

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 die ITurnContext für die aktuelle Drehung.

Konstruktoren

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

Eigenschaften

Name	Beschreibung
ActiveDialog	Erhält die zwischengespeicherte Instanz des aktiven Dialogs oben auf dem Stack oder `null` wenn der Stack leer ist.
Child	Ruft Dialogkontext für untergeordnete Elemente ab, wenn ein aktives untergeordnetes Element vorhanden ist.
Context	Ruft den Kontext für die aktuelle Unterhaltungswende ab.
DialogManager	Veraltet. Erhält den aktuellen DialogManager für diesen dialogContext. Diese Eigenschaft ist veraltet.
Dialogs	Ruft den Satz von Dialogfeldern ab, die für den aktuellen Dialogfeldcontainer aktiv sind.
Parent	Bekommt oder setzt den Elternteil DialogContext, falls vorhanden. Wird beim Suchen nach der ID eines Dialogfelds zum Starten verwendet.
Services	Ruft die Dienstauflistung ab, die kontextbezogen mit diesem Dialogfeldkontext ist.
Stack	Ruft den aktuellen Dialogstapel ab.
State	Ruft den DialogStateManager ab, der die Ansicht aller Speicherbereiche verwaltet, oder legt diesen fest.

Methoden

Name	Beschreibung
BeginDialogAsync(String, Object, CancellationToken)	Startet ein neues Dialogfeld und verschiebt es auf den Dialogstapel.
CancelAllDialogsAsync(Boolean, String, Object, CancellationToken)	Löscht alle vorhandenen Dialogstapel, wodurch alle Dialogfelder im Stapel abgebrochen werden.
CancelAllDialogsAsync(CancellationToken)	Löscht alle vorhandenen Dialogstapel, wodurch alle Dialogfelder im Stapel abgebrochen werden.
ContinueDialogAsync(CancellationToken)	Setzt die Ausführung des aktiven Dialogs fort, falls vorhanden, indem der Strom DialogContext an die ContinueDialogAsync(DialogContext, CancellationToken) Methode des aktiven Dialogs weitergegeben wird.
EmitEventAsync(String, Object, Boolean, Boolean, CancellationToken)	Sucht nach einem Dialogfeld mit einer bestimmten ID. Gibt ein benanntes Ereignis für das aktuelle Dialogfeld oder eine Person aus, die es gestartet hat, um dies zu behandeln.
EndDialogAsync(Object, CancellationToken)	Beendet ein Dialogfeld, indem es aus dem Stapel geschaltet wird, und gibt ein optionales Ergebnis an das übergeordnete Element des Dialogfelds zurück. Das übergeordnete Dialogfeld ist das Dialogfeld, das über einen Aufruf von BeginDialogAsync(String, Object, CancellationToken) oder PromptAsync(String, PromptOptions, CancellationToken)gestartet wurde. Das übergeordnete Dialogfeld enthält die ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) Methode, die mit jedem zurückgegebenen Ergebnis aufgerufen wird. Wenn das übergeordnete Dialogfeld keine `ResumeDialogAsync` Methode implementiert hat, wird es automatisch beendet und das Ergebnis an das übergeordnete Element übergeben. Wenn im Stapel keine übergeordneten Dialogfelder vorhanden sind, wird die Verarbeitung der Drehung beendet.
FindDialog(String)	Suchen Sie die Dialogfeld-ID für den angegebenen Kontext.
GetLocale()	Rufen Sie die CultureInfo in DialogContext ab.
PromptAsync(String, PromptOptions, CancellationToken)	Hilfsfunktion zum Vereinfachen der Formatierung der Optionen zum Aufrufen eines Eingabeaufforderungsdialogfelds. Dieser Helfer nimmt ein Argument `options` an und ruft BeginDialogAsync(String, Object, CancellationToken)dann .
ReplaceDialogAsync(String, Object, CancellationToken)	Startet ein neues Dialogfeld und ersetzt im Stapel das derzeit aktive Dialogfeld durch das neue Dialogfeld. Dies ist besonders nützlich für das Erstellen von Schleifen oder das Umleiten zu einem anderen Dialogfeld.
RepromptDialogAsync(CancellationToken)	Ruft die RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) Methode des derzeit aktiven Dialogfelds auf. Wird mit Dialogfeldern verwendet, die ein erneutes Eingabeaufforderungsverhalten implementieren.

Erweiterungsmethoden

Name	Beschreibung
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)	Ruf den aktiven IDialogDebugger auf und teile ihm mit, dass wir uns an einem bestimmten Punkt im Dialog befinden.
DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)	Ruf den aktiven IDialogDebugger auf und lass ihn wissen, dass wir uns an einem bestimmten Punkt im Recognizer befinden.
DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)	Ruf den aktiven IDialogDebugger an und teile ihm mit, dass wir uns an einem bestimmten Punkt befinden.
DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)	Ruf den aktiven IDialogDebugger auf und lass ihn wissen, dass wir uns an einem bestimmten Punkt im Recognizer befinden.
GetDebugger(DialogContext)	Erweiterungsmethode, um IDialogDebugger aus DialogContext zu erhalten.

Gilt für: