DialogContext Classe

Definizione

Spazio dei nomi:: Microsoft.Bot.Builder.Dialogs

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

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce il contesto per lo stato corrente dello stack di dialoghi.

public class DialogContext

type DialogContext = class

Public Class DialogContext

Ereditarietà: Object
DialogContext

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

Microsoft.Bot.Builder.Dialogs.WaterfallStepContext

Commenti

La proprietà Context contiene il ITurnContext per il turno corrente.

Costruttori

Nome	Descrizione
DialogContext(DialogSet, DialogContext, DialogState)	Inizializza una nuova istanza della classe DialogContext.
DialogContext(DialogSet, ITurnContext, DialogState)	Inizializza una nuova istanza della DialogContext classe dal contesto turno.

Proprietà

Nome	Descrizione
ActiveDialog	Ottiene l'istanza cache del dialogo attivo in cima allo stack o `null` se lo stack è vuoto.
Child	Ottiene il contesto del dialogo per figlio se è presente un elemento figlio attivo.
Context	Ottiene il contesto per il turno corrente della conversazione.
DialogManager	Obsoleti. Riceve l'attuale DialogManager per questo dialogoContext. Questa proprietà è obsoleta.
Dialogs	Ottiene il set di dialoghi attivi per il contenitore della finestra di dialogo corrente.
Parent	Ottiene o imposta il genitore DialogContext, se ce n'è uno. Utilizzato durante la ricerca dell'ID di una finestra di dialogo da avviare.
Services	Ottiene la raccolta di servizi contestuale a questo contesto di dialogo.
Stack	Ottiene lo stack di dialoghi corrente.
State	Ottiene o imposta DialogStateManager che gestisce la visualizzazione di tutti gli ambiti di memoria.

Metodi

Nome	Descrizione
BeginDialogAsync(String, Object, CancellationToken)	Avvia un nuovo dialogo e lo inserisce nello stack di dialoghi.
CancelAllDialogsAsync(Boolean, String, Object, CancellationToken)	Elimina qualsiasi stack di dialoghi esistente annullando così tutti i dialoghi nello stack.
CancelAllDialogsAsync(CancellationToken)	Elimina qualsiasi stack di dialoghi esistente annullando così tutti i dialoghi nello stack.
ContinueDialogAsync(CancellationToken)	Continua l'esecuzione del dialogo attivo, se presente, passando il corrente DialogContext al metodo del ContinueDialogAsync(DialogContext, CancellationToken) dialogo attivo.
EmitEventAsync(String, Object, Boolean, Boolean, CancellationToken)	Cerca una finestra di dialogo con un ID specificato. Genera un evento denominato per la finestra di dialogo corrente, o un utente che lo ha avviato, da gestire.
EndDialogAsync(Object, CancellationToken)	Termina un dialogo estraendolo dallo stack e restituisce un risultato facoltativo all'elemento padre del dialogo. La finestra di dialogo padre è la finestra di dialogo in cui è stato avviato l'oggetto terminato tramite una chiamata a BeginDialogAsync(String, Object, CancellationToken) o PromptAsync(String, PromptOptions, CancellationToken). Il dialogo padre avrà il relativo metodo ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) richiamato con qualsiasi risultato restituito. Se il dialogo padre non ha implementato un metodo `ResumeDialogAsync`, verrà terminato automaticamente e il risultato passato al relativo elemento padre. Se non sono presenti più dialoghi padre nello stack, l'elaborazione del turno terminerà.
FindDialog(String)	Trovare l'ID finestra di dialogo per il contesto specificato.
GetLocale()	Ottenere CultureInfo in DialogContext.
PromptAsync(String, PromptOptions, CancellationToken)	Funzione helper per semplificare la formattazione delle opzioni per chiamare una finestra di dialogo di richiesta. Questo assistente prenderà una `options` discussione e poi chiamerà BeginDialogAsync(String, Object, CancellationToken).
ReplaceDialogAsync(String, Object, CancellationToken)	Avvia un nuovo dialogo e sostituisce nello stack il dialogo attualmente attivo con quello nuovo. Ciò è particolarmente utile per la creazione di cicli o il reindirizzamento a un'altra finestra di dialogo.
RepromptDialogAsync(CancellationToken)	Chiama il metodo RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) del dialogo attualmente attivo. Usato con i dialoghi che implementano un comportamento di ripetizione della richiesta.

Metodi di estensione

Nome	Descrizione
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)	Chiama l'attivo IDialogDebugger e informalo che siamo in un dato punto del dialogo.
DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)	Chiama l'attivo IDialogDebugger e informalo che siamo in un determinato punto nel Riconoscimentore.
DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)	Chiama l'attivo IDialogDebugger e informalo che siamo arrivati a un determinato punto.
DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)	Chiama l'attivo IDialogDebugger e informalo che siamo in un determinato punto nel Riconoscimentore.
GetDebugger(DialogContext)	Metodo di estensione per ottenere IDialogDebugger da DialogContext.

Si applica a