DialogContext Classe

Definição

Namespace:: Microsoft.Bot.Builder.Dialogs

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

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece contexto para o estado atual da pilha de diálogos.

public class DialogContext

type DialogContext = class

Public Class DialogContext

Herança: Object
DialogContext

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

Microsoft.Bot.Builder.Dialogs.WaterfallStepContext

Comentários

A propriedade Context contém o ITurnContext para a curva atual.

Construtores

Nome	Description
DialogContext(DialogSet, DialogContext, DialogState)	Inicializa uma nova instância da classe DialogContext.
DialogContext(DialogSet, ITurnContext, DialogState)	Inicializa uma nova instância da DialogContext classe a partir do contexto turn.

Propriedades

Nome	Description
ActiveDialog	Recebe a instância em cache do diálogo ativo no topo da pilha ou `null` se a pilha estiver vazia.
Child	Obtém o contexto da caixa de diálogo para filho se houver um filho ativo.
Context	Obtém o contexto para a virada atual da conversa.
DialogManager	Obsoleto. Recebe o Gerenciador de Diálogos atual para esse dialogContext. Esta propriedade é obsoleta.
Dialogs	Obtém o conjunto de diálogos que estão ativos para o contêiner de diálogo atual.
Parent	Pega ou define o pai, DialogContextse houver. Usado ao pesquisar a ID de uma caixa de diálogo para iniciar.
Services	Obtém a coleção de serviços que é contextual para esse contexto de caixa de diálogo.
Stack	Obtém a pilha de diálogo atual.
State	Obtém ou define o DialogStateManager que gerencia a exibição de todos os escopos de memória.

Métodos

Nome	Description
BeginDialogAsync(String, Object, CancellationToken)	Inicia uma nova caixa de diálogo e a envia por push para a pilha de diálogo.
CancelAllDialogsAsync(Boolean, String, Object, CancellationToken)	Exclui qualquer pilha de diálogo existente, cancelando todas as caixas de diálogo na pilha.
CancelAllDialogsAsync(CancellationToken)	Exclui qualquer pilha de diálogo existente, cancelando todas as caixas de diálogo na pilha.
ContinueDialogAsync(CancellationToken)	Continua a execução do diálogo ativo, se houver, passando a corrente DialogContext para o método do ContinueDialogAsync(DialogContext, CancellationToken) diálogo ativo.
EmitEventAsync(String, Object, Boolean, Boolean, CancellationToken)	Pesquisa uma caixa de diálogo com uma determinada ID. Emite um evento nomeado para a caixa de diálogo atual, ou alguém que o iniciou, para manipular.
EndDialogAsync(Object, CancellationToken)	Termina uma caixa de diálogo tirando-a da pilha e retornando um resultado opcional para o pai da caixa de diálogo. A caixa de diálogo pai é a caixa de diálogo que começou a ser encerrada por meio de uma chamada para BeginDialogAsync(String, Object, CancellationToken) ou PromptAsync(String, PromptOptions, CancellationToken). A caixa de diálogo pai terá seu método ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) invocado com qualquer resultado retornado. Se a caixa de diálogo pai não tiver implementado um método `ResumeDialogAsync`, ele também será encerrado automaticamente e o resultado será passado para seu pai. Se não houver mais caixas de diálogo pai na pilha, o processamento da curva terminará.
FindDialog(String)	Localize a ID da caixa de diálogo para o contexto fornecido.
GetLocale()	Obtenha o CultureInfo em DialogContext.
PromptAsync(String, PromptOptions, CancellationToken)	Função auxiliar para simplificar a formatação das opções para chamar uma caixa de diálogo de prompt. Esse assistente vai pegar uma `options` discussão e depois ligar BeginDialogAsync(String, Object, CancellationToken).
ReplaceDialogAsync(String, Object, CancellationToken)	Inicia uma nova caixa de diálogo e substitui na pilha a caixa de diálogo atualmente ativa pela nova. Isso é particularmente útil para criar loops ou redirecionar para outra caixa de diálogo.
RepromptDialogAsync(CancellationToken)	Chama o método RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) do diálogo ativo no momento. Usado com caixas de diálogo que implementam um comportamento de prompt novamente.

Métodos de Extensão

Nome	Description
DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)	Ligue para o IDialogDebugger ativo e informe que estamos em um determinado ponto do diálogo.
DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)	Ligue para o IDialogDebugger ativo e informe que estamos em um determinado ponto no Reconhecedor.
DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)	Ligue para o IDialogDebugger ativo e avise que estamos em um determinado ponto.
DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)	Ligue para o IDialogDebugger ativo e informe que estamos em um determinado ponto no Reconhecedor.
GetDebugger(DialogContext)	Método de extensão para obter IDialogDebugger a partir do DialogContext.

Aplica-se a