Partilhar via


DialogContext Classe

Definição

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

public class DialogContext
type DialogContext = class
Public Class DialogContext
Herança
DialogContext
Derivado

Observações

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

Construtores

DialogContext(DialogSet, DialogContext, DialogState)

Inicializa uma nova instância da DialogContext classe .

DialogContext(DialogSet, ITurnContext, DialogState)

Inicializa uma nova instância da classe a DialogContext partir do contexto de viragem.

Propriedades

ActiveDialog

Obtém a instância em cache da caixa de diálogo ativa na parte superior da pilha ou null se a pilha está vazia.

Child

Obtém o contexto de caixa de diálogo do menor se existir um subordinado ativo.

Context

Obtém o contexto da viragem atual da conversação.

DialogManager
Obsoleto.

Obtém o DialogManager atual para esta caixa de diálogoContexto. Esta propriedade é obsoleta.

Dialogs

Obtém o conjunto de caixas de diálogo que estão ativas para o contentor de caixa de diálogo atual.

Parent

Obtém ou define o principal DialogContext, se existir. Utilizado ao procurar o ID de uma caixa de diálogo para iniciar.

Services

Obtém a coleção de serviços que é contextual para este contexto de caixa de diálogo.

Stack

Obtém a pilha de caixa de diálogo atual.

State

Obtém ou define o DialogStateManager, que gere a vista de todos os âmbitos de memória.

Métodos

BeginDialogAsync(String, Object, CancellationToken)

Inicia uma nova caixa de diálogo e envia-a para a pilha de diálogo.

CancelAllDialogsAsync(Boolean, String, Object, CancellationToken)

Elimina qualquer pilha de caixa de diálogo existente, cancelando assim todas as caixas de diálogo na pilha.

CancelAllDialogsAsync(CancellationToken)

Elimina qualquer pilha de caixa de diálogo existente, cancelando assim todas as caixas de diálogo na pilha.

ContinueDialogAsync(CancellationToken)

Continua a execução da caixa de diálogo ativa, se existir uma, ao transmitir a corrente DialogContext para o método da caixa de ContinueDialogAsync(DialogContext, CancellationToken) diálogo ativa.

EmitEventAsync(String, Object, Boolean, Boolean, CancellationToken)

Procura uma caixa de diálogo com um determinado ID. Emite um evento nomeado para a caixa de diálogo atual, ou alguém que o iniciou, para processar.

EndDialogAsync(Object, CancellationToken)

Termina uma caixa de diálogo ao sair da pilha e devolve um resultado opcional para o elemento principal da caixa de diálogo. A caixa de diálogo principal é a caixa de diálogo em que começou a terminar através de uma chamada para BeginDialogAsync(String, Object, CancellationToken) ou PromptAsync(String, PromptOptions, CancellationToken). A caixa de diálogo principal terá o método ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) invocado com qualquer resultado devolvido. Se a caixa de diálogo principal não tiver implementado um ResumeDialogAsync método, o mesmo também será automaticamente terminado e o resultado será transmitido para o respetivo principal. Se não existirem mais caixas de diálogo principais na pilha, o processamento da curva terminará.

FindDialog(String)

Localize o ID da caixa de diálogo para o contexto especificado.

GetLocale()

Obtenha 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 pedido. Este programa auxiliar aceita um options argumento e, em seguida, chama 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. Isto é particularmente útil para criar ciclos ou redirecionar para outra caixa de diálogo.

RepromptDialogAsync(CancellationToken)

Chama o método da caixa de RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) diálogo atualmente ativa. Utilizado com caixas de diálogo que implementam um comportamento de nova solicitação.

Métodos da Extensão

DebuggerStepAsync(DialogContext, OnCondition, DialogEvent, CancellationToken)

Chame o IDialogDebugger ativo e informe-o de que estamos num determinado momento.

DebuggerStepAsync(DialogContext, Dialog, String, CancellationToken)

Chame o IDialogDebugger ativo e informe-o de que estamos num determinado ponto na caixa de diálogo.

DebuggerStepAsync(DialogContext, Recognizer, String, CancellationToken)

Chame o IDialogDebugger ativo e informe-o de que estamos num determinado ponto no Reconhecedor.

DebuggerStepAsync(DialogContext, IRecognizer, String, CancellationToken)

Chame o IDialogDebugger ativo e informe-o de que estamos num determinado ponto no Reconhecedor.

GetDebugger(DialogContext)

Método de extensão para obter o IDialogDebugger a partir de DialogContext.

Aplica-se a